Package google.mybusiness.businessinformation.v1

Dizin

AttributesService

Müşterilerin belirli bir konumla ilgili özellikleri aramasına ve güncellemesine olanak tanır.

GetAttributes

rpc GetAttributes(GetAttributesRequest) returns (Attributes)

Belirli bir konum için ayarlanan tüm özellikleri arar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

GetGoogleUpdatedAttributes

rpc GetGoogleUpdatedAttributes(GetGoogleUpdatedAttributesRequest) returns (Attributes)

Belirtilen konumun Google tarafından güncellenmiş sürümünü alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

ListAttributeMetadata

rpc ListAttributeMetadata(ListAttributeMetadataRequest) returns (ListAttributeMetadataResponse)

Belirtilen birincil kategori ve ülkeye sahip bir konum için kullanılabilecek özelliklerin listesini döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

UpdateAttributes

rpc UpdateAttributes(UpdateAttributesRequest) returns (Attributes)

Belirli bir konumun özelliklerini güncelleme.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

CategoriesService

Bu API, Google'da işletmenin bulunduğu konumlar için desteklenen kategoriler hakkında bilgi sağlar. Referans için bu makalenin kategoriler bölümüne bakın: https://support.google.com/business/answer/3038177

BatchGetCategories

rpc BatchGetCategories(BatchGetCategoriesRequest) returns (BatchGetCategoriesResponse)

Sağlanan dil ve GConcept kimlikleri için işletme kategorilerinin bir listesini döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

ListCategories

rpc ListCategories(ListCategoriesRequest) returns (ListCategoriesResponse)

İşletme kategorilerinin listesini döndürür. Arama, kategori adıyla eşleşir ancak kategori kimliğiyle eşleşmez.

Arama, yalnızca kategori adının ön kısmıyla eşleşir (yani "yemek", "Yemek Alanı" döndürebilir ancak "Fast Food Restoranı" ifadesini döndürmez).

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Zincirler

Bir zincir işletme hakkında bilgi aramak için kullanılan bir hizmet.

GetChain

rpc GetChain(GetChainRequest) returns (Chain)

Belirtilen zinciri alır. Zincir yoksa NOT_FOUND değerini döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

SearchChains

rpc SearchChains(SearchChainsRequest) returns (SearchChainsResponse)

Zincir adına göre zincirde arama yapar.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

GoogleLocations

Bu API, GoogleLocation'a erişme ve arama yapma olanağı tanır.

SearchGoogleLocations

rpc SearchGoogleLocations(SearchGoogleLocationsRequest) returns (SearchGoogleLocationsResponse)

Belirtilen istekle eşleşen olası tüm konumları arayın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Konumlar

Bu API, Google'daki işletme konumlarının yönetilmesine olanak tanır.

CreateLocation

rpc CreateLocation(CreateLocationRequest) returns (Location)

Giriş yapmış kullanıcıya ait olacak yeni bir Konum oluşturur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

DeleteLocation

rpc DeleteLocation(DeleteLocationRequest) returns (Empty)

Konum silinir.

Bu konum, API kullanılarak silinemiyor ve google.mybusiness.businessinformation.v1.LocationState içinde işaretlenmişse Google İşletme Profili web sitesini kullanın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

GetGoogleUpdatedLocation

rpc GetGoogleUpdatedLocation(GetGoogleUpdatedLocationRequest) returns (GoogleUpdatedLocation)

Belirtilen konumun Google tarafından güncellenmiş sürümünü alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Konum Alma

rpc GetLocation(GetLocationRequest) returns (Location)

Belirtilen konumu döndürür.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

ListLocations

rpc ListLocations(ListLocationsRequest) returns (ListLocationsResponse)

Belirtilen hesaba ilişkin konumları listeler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

UpdateLocation

rpc UpdateLocation(UpdateLocationRequest) returns (Location)

Belirtilen konumu günceller.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/business.manage

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

AdWordsLocationExtensions

AdWords'de gösterilen ek bilgiler.

Alanlar
ad_phone

string

Zorunlu. AdWords yer uzantılarında, konumun birincil telefon numarası yerine görüntülenecek alternatif bir telefon numarası.

Özellik

Konum özelliği. Özellikler, bir konum hakkında ek bilgi sağlar. Bir konum için ayarlanabilecek özellikler, söz konusu konumun özelliklerine (ör. kategori) göre değişiklik gösterebilir. Kullanılabilir özellikler Google tarafından belirlenir ve API değişiklikleri olmadan eklenip kaldırılabilir.

Alanlar
name

string

Zorunlu. Bu özelliğin kaynak adı.

value_type

AttributeValueType

Yalnızca çıkış. Bu özelliğin içerdiği değerin türü. Bu, değerin nasıl yorumlanacağını belirlemek için kullanılmalıdır.

values[]

Value

Bu özelliğin değerleri. Sağlanan değerlerin türü, söz konusu özellik için beklenen türle eşleşmelidir. Bu, birden fazla özellik değerinin sağlanabileceği yinelenen bir alandır. Özellik türleri yalnızca bir değeri destekler.

repeated_enum_value

RepeatedEnumAttributeValue

Özellik değeri türü REPEATED_ENUM olduğunda bu, özellik değerini içerir ve diğer değerler alanları boş olmalıdır.

uri_values[]

UriAttributeValue

Özellik değeri türü URL olduğunda bu alan, söz konusu özelliğe ait değerleri içerir ve diğer değerler alanları boş olmalıdır.

AttributeMetadata

Bir özelliğin meta verileri. Yerelleştirilmiş bir ad ve ilgili özellikleri gruplandırmaya yönelik bir başlık da dahil olmak üzere, özelliğin görünen bilgilerini içerir.

Alanlar
parent

string

Özelliğin benzersiz tanımlayıcısıdır.

value_type

AttributeValueType

Özelliğin değer türü. Ayarlanan ve alınan değerlerin bu türde olması beklenmelidir.

display_name

string

Varsa özelliğin yerelleştirilmiş görünen adı; aksi takdirde, İngilizce görünen ad kullanılır.

group_display_name

string

Bu özelliği içeren grubun (varsa) yerelleştirilmiş görünen adı; Aksi takdirde, İngilizce grup adıdır. İlgili özellikler bir grup halinde toplanır ve burada verilen başlığın altında birlikte görüntülenmelidir.

repeatable

bool

True (doğru) ise özellik birden çok değeri destekler. Yanlış ise yalnızca tek bir değer sağlanmalıdır.

value_metadata[]

AttributeValueMetadata

Bazı özellik türleri (ör. numaralandırmalar) için desteklenen değerlerin ve bu değerlere karşılık gelen görünen adların listesi sağlanır.

deprecated

bool

True (doğru) ise, özellik desteği sonlandırılmıştır ve artık kullanılmamalıdır. Kullanımdan kaldırılırsa bu özelliğin güncellenmesi hataya neden olmaz ancak güncellemeler kaydedilmez. Kullanımdan kaldırıldıktan sonra bu özellik tamamen kaldırılır ve hataya dönüşür.

AttributeValueMetadata

Desteklenen özellik değerlerinin meta verileri.

Alanlar
value

Value

Özellik değeri.

display_name

string

Bu değerin görünen adı (kullanılabilir olduğunda yerelleştirilmiş); İngilizce olarak görürsünüz. Değerin görünen adı, özelliğin görünen adıyla bağlamda kullanılmak üzere tasarlanmıştır.

Örneğin, "Kablosuz" enum özelliği, bu "Ücretli" özelliğini içerebilir temsil eder.

AttributeValueType

Özelliğin değer türü.

Sıralamalar
ATTRIBUTE_VALUE_TYPE_UNSPECIFIED Belirtilmedi.
BOOL Bu özelliğin değerleri boole değerleridir.
ENUM Özellik, kullanılabilecek değerlerin önceden belirlenmiş bir listesine sahiptir. Bu özelliğin meta verilerinde bu değerler listelenir.
URL Bu özelliğin değerleri URL'dir.
REPEATED_ENUM Özellik değeri, açıkça ayarlanabilen veya ayarlanabilen birden çok olası değere sahip bir sıralamadır.

Özellikler

Belirli bir konuma ait tüm özelliklerin kapsayıcısıdır.

Alanlar
name

string

Zorunlu. Bu konum için Google'ın locations/{location_id}/attributes biçimindeki tanımlayıcısı.

attributes[]

Attribute

Güncellenmesi gereken bir özellik koleksiyonu.

BatchGetCategoriesRequest

BusinessCategory.BatchGetBusinessCategory için istek mesajı.

Alanlar
names[]

string

Zorunlu. En az bir ad belirlenmelidir. Yerelleştirilmiş kategori adlarının döndürüleceği GConcept kimlikleri. Birden fazla kategorinin ayrıntılarını döndürmek için istekte bu parametreyi tekrarlayın.

language_code

string

Zorunlu. Kategori adlarının döndürülmesi gereken BCP 47 dil kodu.

region_code

string

İsteğe bağlı. Standart olmayan dili belirlemek için kullanılan ISO 3166-1 alpha-2 ülke kodu.

view

CategoryView

Zorunlu. Yanıtta Kategori kaynağının hangi bölümlerinin döndürüleceğini belirtir.

BatchGetCategoriesResponse

BusinessCategory.BatchGetBusinessCategory için yanıt iletisi.

Alanlar
categories[]

Category

İstekte sağlanan GConcept kimlikleriyle eşleşen kategoriler. Bunlar, istekteki kategori kimlikleriyle aynı sırada olmayacaktır.

BusinessHours

Bu konumun faaliyete açık olduğu dönemleri gösterir. [TimePeriod][google.mybusiness.mybusinessinformation.v1.TimePeriod] örneklerinden oluşan bir koleksiyon içerir.

Alanlar
periods[]

TimePeriod

Zorunlu. Bu konumun açık olduğu zaman koleksiyonu. Her dönem, konumun hafta içinde açık olduğu saat aralığını temsil eder.

Kategoriler

İşletmeyi tanımlayan bir kategori koleksiyonu. Güncellemeler sırasında her iki alan da ayarlanmalıdır. Müşterilerin, güncelleme maskesini kullanarak birincil veya ek kategorileri tek tek güncellemesi yasaktır.

Alanlar
primary_category

Category

Zorunlu. Bu konumun faaliyet gösterdiği temel işi en iyi açıklayan kategori.

additional_categories[]

Category

İsteğe bağlı. İşletmenizi tanımlayan ek kategoriler. Kategoriler, müşterilerinizin ilgilendikleri hizmetlerle ilgili doğru ve spesifik sonuçlar bulmasına yardımcı olur. İşletme bilgilerinizin doğru ve güncel olmasını sağlamak için, ana faaliyet alanınızı genel olarak tarif ederken mümkün olduğunca az sayıda kategori kullandığınızdan emin olun. Mümkün olduğunca spesifik ancak ana faaliyet alanınızı da temsil eden kategoriler seçin.

Kategori

İşletmenin ne olduğunu (ne yaptığını değil) açıklayan bir kategori. Geçerli kategori kimliklerinin listesi ve kullanıcılar tarafından okunabilen adların eşlemeleri için categories.list adresine bakın.

Alanlar
name

string

Zorunlu. Bu kategori için sabit bir kimlik (Google tarafından sağlanır). Değer, kategori değiştirilirken (konum oluştururken veya güncellerken) belirtilmelidir.

display_name

string

Yalnızca çıkış. Kategorinin kullanıcılar tarafından okunabilen adı. Bu, konum okunurken ayarlanır. Konum değiştirilirken category_id ayarlanmalıdır.

service_types[]

ServiceType

Yalnızca çıkış. Bu işletme kategorisinde kullanılabilen tüm hizmet türlerinin listesi.

more_hours_types[]

MoreHoursType

Yalnızca çıkış. Bu işletme kategorisi için kullanabileceğiniz diğer çalışma saati türleri.

CategoryView

Sunucu tarafından döndürülen veri miktarını sınırlamaya yardımcı olan bir sıralama.

Sıralamalar
CATEGORY_VIEW_UNSPECIFIED Belirtilmedi, CATEGORY_METADATA_ONLY ile eşdeğer.
BASIC Sunucu yanıtı yalnızca display_name, category_id ve language_code Kategori alanlarını içerir. Hizmet türüyle ilgili meta verilerle ilgili tüm alanları atlar.
FULL Yanıttaki tüm alanları döndürür.

Zincir

Zincir, işletmenizin bulunduğu konumların ilişkili olabileceği markadır.

Alanlar
name

string

Zorunlu. Zincirin chains/{chain_id} biçimindeki kaynak adı.

chain_names[]

ChainName

Zincirin adları.

websites[]

ChainUri

Zincirin web siteleri.

location_count

int32

Bu zincir kapsamındaki konumların sayısıdır.

ChainName

Zincir görüntülenirken kullanılacak ad.

Alanlar
display_name

string

Bu zincir için görünen addır.

language_code

string

Adın BCP 47 dil kodu.

ChainUri

Zincir gösterilirken kullanılacak URL.

Alanlar
uri

string

Bu zincirin URI'sı.

CreateLocationRequest

Konumlar.CreateLocation için istek iletisi.

Alanlar
parent

string

Zorunlu. Bu konumun oluşturulacağı hesabın adı.

location

Location

Zorunlu. Yeni konum meta verileri.

validate_only

bool

İsteğe bağlı. True (doğru) ise istek, fiilen konum oluşturulmadan doğrulanır.

request_id

string

İsteğe bağlı. Sunucunun yinelenen istekleri algılaması için benzersiz bir istek kimliği. UUID'leri kullanmanızı öneririz. Maksimum uzunluk 50 karakterdir.

DeleteLocationRequest

locations.DeleteLocation için istek mesajı.

Alanlar
name

string

Zorunlu. Silinecek konumun adı.

ErrorCode

API tarafından döndürülen tüm hata kodları.

Sıralamalar
ERROR_CODE_UNSPECIFIED Hata kodu eksik.
INVALID_ATTRIBUTE_NAME Sağlanan özelliklerden biri bu konuma uygulanamaz. Yalnızca ListAttributeMetadata yanıtında döndürülen özellikler bu konuma uygulanabilir. Sorunlu tüm özellik adları meta veriler altındaki attribute_names anahtarında döndürülür.
ASSOCIATE_OPERATION_ON_VERIFIED_LOCATION Bu hata, bir müşteri doğrulanmış durumdaki bir konumdaki bir konumu ilişkilendirmeye veya konum ilişkilendirmesini temizlemeye çalıştığında döndürülür.
ASSOCIATE_LOCATION_INVALID_PLACE_ID associateLocation isteğinde sağlanan place_id, konumla eşleşmiyor veya geçersiz. Ayarlanan place_id değerinin, SearchGoogleLocations yanıtında döndürülen kimliklerden biriyle eşleştiğinden emin olun.
LAT_LNG_UPDATES_NOT_PERMITTED Bu projenin, Konum'daki lat/lng alanını güncellemesine izin verilmiyor. Kullanıcı arayüzündeki raptiye bırakma işlevini kullanarak enlem/boylam değerlerini güncelleyebilir veya bize bir adres verebilirsiniz.
PO_BOX_IN_ADDRESS_NOT_ALLOWED Adreste posta kutusu kullanılamaz. Meta veri anahtarları arasında "field_mask" bulunur.
BLOCKED_REGION Uymak zorunda olduğumuz uluslararası yaptırımlar nedeniyle bu bölgedeki işletmeleri kabul edemiyoruz. Meta veri anahtarları "field_maks" içerir.
MISSING_BOTH_PHONE_AND_WEBSITE CUSTOMER_LOCATION_ONLY işletmeler için telefon veya web sitesi gereklidir. Meta veri anahtarları arasında "field_mask" bulunur.
MISSING_STOREFRONT_ADDRESS_OR_SAB Tüm Konumlar'ın en azından bir vitrin adresi veya hizmet bölgesi olmalıdır. Meta veri anahtarları arasında "field_mask" bulunur.
LAT_LNG_TOO_FAR_FROM_ADDRESS Enlem/boylam ve adres çifti birbirinden çok uzak. Meta veri anahtarları arasında "field_mask" bulunur.
LAT_LNG_REQUIRED KULLANIMDAN KALDIRILDI. PIN_DROP_REQUIRED ile değiştirilecek. Belirtilen adres bulunamıyor. Lütfen bir enlem/boylam girin. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_CHARACTERS Geçersiz karakterler bulundu. Meta veri anahtarları şu şekildedir: "field_mask" ve "geçersiz_karakterler".
FORBIDDEN_WORDS Yasak kelimeler bulundu. Meta veri anahtarları şu şekildedir: "field_mask" ve "yasak_kelimeler".
INVALID_INTERCHANGE_CHARACTERS Geçersiz karakterler bulundu. Meta veri anahtarları arasında "field_mask" bulunur.
FIELDS_REQUIRED_FOR_CATEGORY Bu konum kategorisi için ek alanlar gereklidir. Meta veri anahtarları arasında "field_mask", "value" ve "fields_required" bulunur.
STOREFRONT_REQUIRED_FOR_CATEGORY İşletme kategoriniz için müşterilerin ziyaret edebileceği bir vitrin konumu gerekir. Meta veri anahtarları arasında "field_mask" bulunur.
ADDRESS_MISSING_REGION_CODE Adreste zorunlu bölge_kodu eksik. Meta veri anahtarları arasında "field_mask" bulunur.
ADDRESS_EDIT_CHANGES_COUNTRY Adres farklı bir ülkeye taşınamaz. Meta veri anahtarları arasında "field_mask" bulunur.
SPECIAL_HOURS_SET_WITHOUT_REGULAR_HOURS Özel çalışma saatleri yalnızca konumun normal çalışma saatleri varsa belirtilebilir. Meta veri boş.
INVALID_TIME_SCHEDULE Geçersiz zaman planlaması, çakışan veya bitiş zamanı, başlangıç zamanından önce. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_HOURS_VALUE Geçersiz saat biçimi veya değeri. Meta veri anahtarları arasında "field_mask" bulunur.
OVERLAPPED_SPECIAL_HOURS Özel saatler çakışamaz. Meta veri anahtarları arasında "field_mask" bulunur.
INCOMPATIBLE_MORE_HOURS_TYPE_FOR_CATEGORY İşletmenizin birincil kategorisi bu saat türünü desteklemiyor. Meta veri anahtarları şu şekildedir: "field_mask" ve "inuyumlu_saat_türü".
DUPLICATE_CHILDREN_LOCATIONS related_data içinde yinelenen alt_konumlar var. Meta veri anahtarları arasında "field_mask" bulunur.
INCOMPATIBLE_SERVICE_AREA_AND_CATEGORY Hizmet bölgesi işletmesi, seçilen birincil kategoriye sahip olamaz. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_SERVICE_AREA_PLACE_ID service_area alanında geçersiz Place_id var. Meta veri anahtarları şu şekildedir: "field_mask" ve "place_id" değerleridir.
INVALID_AREA_TYPE_FOR_SERVICE_AREA service_area için geçersiz alan türü. Meta veri anahtarları şu şekildedir: "field_mask" ve "place_id" değerleridir.
OPENING_DATE_TOO_FAR_IN_THE_FUTURE Açılış tarihini bir yıl içinde olacak şekilde girin. Meta veri anahtarları arasında "field_mask" bulunur.
OPENING_DATE_MISSING_YEAR_OR_MONTH Açılış tarihinde yıl veya ay belirtilmelidir. Meta veri anahtarları arasında "field_mask" bulunur.
OPENING_DATE_BEFORE_1AD Açılış tarihi MS 1'den önce olamaz. Meta veri anahtarları arasında "field_mask" bulunur.
TOO_MANY_ENTRIES Alan için çok fazla giriş var. Meta veri anahtarları şu şekildedir: "field_mask" ve "max_count".
INVALID_PHONE_NUMBER Telefon numarası girişi tanınmadı. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
INVALID_PHONE_NUMBER_FOR_REGION Bölge için geçersiz telefon numarası. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
MISSING_PRIMARY_PHONE_NUMBER Birincil telefon numarası eksik. Meta veri anahtarları arasında "field_mask" bulunur.
THROTTLED Alan şu anda güncellenemiyor. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
UNSUPPORTED_POINT_RADIUS_SERVICE_AREA Nokta yarıçapı hizmet bölgeleri artık desteklenmiyor. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_CATEGORY Geçersiz kategori kimliği. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
CANNOT_REOPEN İşletme yeniden açılamıyor. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_BUSINESS_OPENING_DATE İşletme açılış tarihi geçersiz. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_LATLNG Geçersiz latlng. Meta veri anahtarları arasında "field_mask" bulunur.
PROFILE_DESCRIPTION_CONTAINS_URL İşletme açıklaması URL içermemelidir. Meta veri anahtarları arasında "field_mask" bulunur.
LODGING_CANNOT_EDIT_PROFILE_DESCRIPTION Konaklama yerinin profil açıklaması düzenlenemez. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_URL Geçersiz bağlantı. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_ADDRESS Geçersiz adres. Meta veri anahtarları arasında "field_mask" bulunur.
PARENT_CHAIN_CANNOT_BE_THE_LOCATION_ITSELF ParentChain, konumun kendisi olamaz. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
RELATION_CANNOT_BE_THE_LOCATION_ITSELF İlişki, konumun kendisi olamaz. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
MISSING_ADDRESS_COMPONENTS Adres bileşenlerinin değeri eksik. Meta veri anahtarları arasında "field_mask" bulunur.
READ_ONLY_ADDRESS_COMPONENTS Salt okunur adres bileşenleri düzenlenemiyor. Meta veri anahtarları arasında "field_mask" bulunur.
STRING_TOO_LONG Dize çok uzun. Meta veri anahtarları şu şekildedir: "field_mask" ve "max_length" değerleridir.
STRING_TOO_SHORT Dize çok kısa. Meta veri anahtarları şu şekildedir: "field_mask" ve "min_length" değerleridir.
REQUIRED_FIELD_MISSING_VALUE Zorunlu alanda değer eksik. Meta veri anahtarları arasında "field_mask" bulunur.
ATTRIBUTE_PROVIDER_URL_NOT_ALLOWED Sağlayıcının URL'si eklenemez veya düzenlenemez. Meta veri anahtarları "attribute_name" değerini içerir.
ATTRIBUTE_INVALID_ENUM_VALUE Sıralama özelliği için bilinmeyen değer. Meta veri anahtarları "attribute_name" değerini içerir.
ATTRIBUTE_NOT_AVAILABLE Ölçeklenebilir özellik bu konum için geçerli değil. Meta veri anahtarları ""attribute_name" değerini içerir.
ATTRIBUTE_CANNOT_BE_REPEATED Ölçeklenebilir özellik yalnızca bir kez belirtilebilir. Meta veri anahtarları "attribute_name" değerini içerir.
ATTRIBUTE_TYPE_NOT_COMPATIBLE_FOR_CATEGORY Ölçeklenebilir özellik, konumda ayarlanan kategorilerle uyumlu değil. Meta veri anahtarları "attribute_name" değerini içerir.
ADDRESS_REMOVAL_NOT_ALLOWED İşletmeniz için adres kaldırmaya izin verilmiyor. Meta veri anahtarları arasında "field_mask" bulunur.
AMBIGUOUS_TITLE En iyi ad bir dil için belirsiz. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_CATEGORY_FOR_SAB Saf SAB'da, gcid:sistem_poi'nin alt türleri olan gcid'ler bulunamaz. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
RELATION_ENDPOINTS_TOO_FAR İlişki uç noktaları birbirinden çok uzak. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.
INVALID_SERVICE_ITEM Yapılandırılmış_hizmet_öğesi ve serbest_form_hizmet_öğesi ayarlanmamış. Meta veri anahtarları arasında "field_mask" bulunur.
SERVICE_ITEM_LABEL_NO_DISPLAY_NAME Etikette görünen ad yok. Meta veri anahtarları arasında "field_mask" bulunur.
SERVICE_ITEM_LABEL_DUPLICATE_DISPLAY_NAME Görünen ad, tüm fiyat listelerindeki tüm etiketler için benzersiz değil. Meta veri anahtarları arasında "field_mask" bulunur.
SERVICE_ITEM_LABEL_INVALID_UTF8 Etiket, geçersiz UTF-8 simgeleri içeriyor. Meta veri anahtarları arasında "field_mask" bulunur.
FREE_FORM_SERVICE_ITEM_WITH_NO_CATEGORY_ID free_form_service_item öğesinde category_id alanı eksik. Meta veri anahtarları arasında "field_mask" bulunur.
FREE_FORM_SERVICE_ITEM_WITH_NO_LABEL free_form_service_item öğesinde etiket eksik. Meta veri anahtarları arasında "field_mask" bulunur.
SERVICE_ITEM_WITH_NO_SERVICE_TYPE_ID structured_service_item öğesinde service_type_id alanı eksik. Meta veri anahtarları arasında "field_mask" bulunur.
INVALID_LANGUAGE Dil kodu geçersiz. Meta veri anahtarları arasında "field_mask" bulunur.
PRICE_CURRENCY_MISSING ISO 4217 para birimi kodu eksik. Meta veri anahtarları arasında "field_mask" bulunur.
PRICE_CURRENCY_INVALID Belirtilen para birimi kodu, ISO 4217 geçerli değil. Meta veri anahtarları arasında "field_mask" bulunur.
SERVICE_TYPE_ID_DUPLICATE Hizmet türü kimlikleri Konum içinde benzersiz değil. Meta veri anahtarları arasında "field_mask" bulunur.
PIN_DROP_REQUIRED Belirtilen adres bulunamıyor. Raptiye bırakma için lütfen kullanıcı arayüzünü kullanın. Meta veri anahtarları arasında "field_mask" bulunur.
STALE_DATA Bir veya daha fazla öğe kısa süre önce Google tarafından güncellendi. "field" (alan) alanında bulunan verilerde yalnızca bu işletmenin sahibi değişiklik yapabilir şu an için business.google.com adresini ziyaret edin. Meta veri anahtarları arasında "field_mask" bulunur.
PHONE_NUMBER_EDITS_NOT_ALLOWED Telefon numarası alanı bu konum için devre dışı bırakıldı ve düzenlenmesine izin verilmiyor. Meta veri anahtarları arasında "field_mask" bulunur.
MULTIPLE_ORGANIZATIONALLY_PART_OF_RELATION İki konum arasındaki mantıksal ilişkiyi (ör. çalışma durumunun bozulması, çalışmasını sağlayan) birden fazla ilişki vardır. Meta veri anahtarları şu şekildedir: "field_mask" ve "value" gibi ek özellikler içerir.

GetAttributesRequest

AttributesService.GetAttributes isteği.

Alanlar
name

string

Zorunlu. Bu konum için Google'ın locations/{location_id}/attributes biçimindeki tanımlayıcısı.

GetChainRequest

Konumlar.GetChain için istek mesajı.

Alanlar
name

string

Zorunlu. Zincirin chains/{chain_place_id} biçimindeki kaynak adı.

GetGoogleUpdatedAttributesRequest

AttributesService.GetGoogleUpdatedAttributes isteği.

Alanlar
name

string

Zorunlu. Bu konum için Google'ın locations/{location_id}/attributes biçimindeki tanımlayıcısı.

GetGoogleUpdatedLocationRequest

Konumlar.GetGoogleUpdatedLocation için istek mesajı.

Alanlar
name

string

Zorunlu. Alınacak konumun adı.

read_mask

FieldMask

Zorunlu. Yanıtta hangi alanların döndürüleceğini belirtmek için okuma maskesi.

GetLocationRequest

Konumlar.GetLocation için istek iletisi.

Alanlar
name

string

Zorunlu. Alınacak konumun adı.

read_mask

FieldMask

Zorunlu. Yanıtta hangi alanların döndürüleceğini belirtmek için okuma maskesi.

GoogleLocation

Google'da mevcut bir Location temsil eder. Bu, kullanıcı veya başkası tarafından hak talebinde bulunulmuş ya da hak talebinde bulunulmamış bir konum olabilir.

Alanlar
name

string

Bu GoogleLocation öğesinin googleLocations/{googleLocationId} biçimindeki kaynak adı.

location

Location

Seyrek doldurulmuş Location bilgileri. Şu anda bir kullanıcı tarafından hak talebinde bulunulmadıysa bu alan CreateLocation içinde yeniden kullanılabilir.

request_admin_rights_uri

string

Kullanıcıyı istek yöneticisi hakları kullanıcı arayüzüne yönlendirecek bir URL. Bu alan yalnızca, konumla ilgili geçerli kullanıcı da dahil olmak üzere herhangi bir kullanıcı tarafından hak talebinde bulunulmuşsa gösterilir.

GoogleUpdatedLocation

Google tarafından değiştirilen bir konumu gösterir.

Alanlar
location

Location

Bu konumun Google tarafından güncellenmiş sürümü.

diff_mask

FieldMask

Google'ın güncellediği alanlar.

pending_mask

FieldMask

Haritalar ve Arama'ya aktarılmamış, bekleyen düzenlemeleri olan alanlar.

Şirket

Fiyat listesi, bölüm veya öğe gösterilirken kullanılacak etiket.

Alanlar
display_name

string

Zorunlu. Fiyat listesi, bölüm veya öğe için görünen ad.

description

string

İsteğe bağlı. Fiyat listesinin, bölümün veya öğenin açıklaması.

language_code

string

İsteğe bağlı. Bu dizelerin geçerli olduğu BCP-47 dil kodu. Her dil için yalnızca bir etiket grubu ayarlanabilir.

ListAttributeMetadataRequest

AttributesService.ListAttributeMetadata isteği.

Alanlar
parent

string

Kullanılabilir özellikleri aramak için konumun kaynak adı. Bu alan ayarlanırsa category_name, region_code, language_code ve show_all gerekli değildir ve ayarlanmamalıdır.

category_name

string

Kullanılabilir özellikleri bulmak için birincil kategori sabit kimliği. Biçim kategorilerinde/{category_id} olmalıdır.

region_code

string

Kullanılabilir özellikleri bulmak için kullanılan ISO 3166-1 alpha-2 ülke kodu.

language_code

string

Özellik görünen adlarının alınacağı BCP 47 dil kodu. Bu dil mevcut değilse İngilizce olarak sağlanır.

show_all

bool

Bu alan doğru değerine ayarlandığında üst ve kategori_adı alanları dikkate alınmadan, kullanılabilir tüm özelliklerin meta verileri döndürülür. "show_all" doğru değerine ayarlandığında dil_kodu ve bölge_kodu zorunludur.

page_size

int32

Sayfa başına eklenecek özellik sayısı. Varsayılan değer 200, minimum değer ise 1'dir.

page_token

string

Belirtilirse özellik meta verilerinin sonraki sayfası alınır.

ListAttributeMetadataResponse

AttributesService.ListAttributeMetadata yanıtı.

Alanlar
attribute_metadata[]

AttributeMetadata

Kullanılabilir özellikler için özellik meta verisi koleksiyonu.

next_page_token

string

Özellik sayısı istenen sayfa boyutunu aşıyorsa bu alan, attributes.list için yapılan bir sonraki çağrıda özelliklerin sonraki sayfasını getirmek üzere bir jetonla doldurulur. Başka özellik yoksa bu alan yanıtta yer almaz.

ListCategoriesRequest

BusinessCategory.ListCategory için istek mesajı.

Alanlar
region_code

string

Zorunlu. ISO 3166-1 alpha-2 ülke kodu.

language_code

string

Zorunlu. BCP 47 dil kodu.

filter

string

İsteğe bağlı. Kullanıcının filtre dizesi. Desteklenen tek alan: displayName. Örnek: filter=displayName=foo.

page_size

int32

İsteğe bağlı. Sayfa başına getirilecek kategori sayısı. Varsayılan değer 100, minimum değer 1 ve maksimum sayfa boyutu 100'dür.

page_token

string

İsteğe bağlı. Belirtilirse kategorilerin sonraki sayfası getirilir.

view

CategoryView

Zorunlu. Yanıtta Kategori kaynağının hangi bölümlerinin döndürüleceğini belirtir.

ListCategoriesResponse

BusinessCategory.ListCategory için yanıt iletisi.

Alanlar
categories[]

Category

İstenen parametrelere göre eşleşen kategoriler.

next_page_token

string

Kategori sayısı, istenen sayfa boyutunu aşıyorsa bu alan, ListCategories çağrısında bulunan bir sonraki kategori sayfasını getirmek için bir jetonla doldurulur.

ListLocationsRequest

locations.ListLocations için istek mesajı.

Alanlar
parent

string

Zorunlu. Konumların alınacağı hesabın adı. Üst hesap [Account] ise [google.mybusiness.accountmanagement.v1.Account], [AccountType] türünde [google.mybusiness.accountmanagement.v1.Account.AccountType] KİŞİSEL, yalnızca doğrudan Hesaba ait olan Konumlar döndürülür. Aksi takdirde, Hesap'tan erişilebilen tüm konumları doğrudan veya dolaylı olarak döndürecektir.

page_size

int32

İsteğe bağlı. Sayfa başına getirilecek konum sayısı. Ayarlanmazsa varsayılan değer 10'dur. Minimum 1, maksimum sayfa boyutu 100'dür.

page_token

string

İsteğe bağlı. Belirtilirse sonraki page konumu getirir. Sayfa jetonu, istenen sayfa boyutuna sığabilecek daha fazla konum olduğunda önceki ListLocations çağrıları tarafından döndürülür.

filter

string

İsteğe bağlı. Döndürülecek konumları kısıtlayan bir filtre. Yanıt yalnızca filtreyle eşleşen girişleri içerir. filter boşsa kısıtlamalar uygulanır ve istenen hesap için tüm konumlar (sayfalara ayrılmış) alınır.

Geçerli alanlar ve örnek kullanım hakkında daha fazla bilgi için Konum Verileriyle Çalışma Kılavuzu'na bakın.

order_by

string

İsteğe bağlı. İstek için sıralama düzeni. Birden çok alan, SQL söz dizimine uygun şekilde virgülle ayrılmalıdır. Varsayılan sıralama düzeni artan düzendir. Azalan sırayı belirtmek için " azl" eklenmelidir. order_by için geçerli alanlar title [başlık] ve store_code (mağaza_kodu) şeklindedir. Örneğin: "başlık, mağaza_kodu açıklaması" veya "başlık" veya "store_code desc" (mağaza_kodu açıklaması)

read_mask

FieldMask

Zorunlu. Yanıtta hangi alanların döndürüleceğini belirtmek için okuma maskesi.

ListLocationsResponse

locations.ListLocations için yanıt iletisi.

Alanlar
locations[]

Location

Konumlar.

next_page_token

string

Konum sayısı istenen sayfa boyutunu aşıyorsa bu alan, bir sonraki ListLocations çağrısında konumların sonraki sayfasını getirmek için bir jetonla doldurulur. Başka konum yoksa bu alan yanıtta mevcut değildir.

total_size

int32

Sayfalara ayırmadan bağımsız olarak listedeki yaklaşık Konum sayısı. Bu alan yalnızca sorgu parametresi olarak filter kullanılıyorsa döndürülür.

Konum

Konum. Bu alanların ayrıntılı açıklaması için yardım merkezi makalesine veya geçerli işletme kategorilerinin listesi için kategori uç noktasına bakın.

Alanlar
name

string

Bu konum için Google tanımlayıcısı şu biçimdedir: locations/{location_id}.

language_code

string

Sabit. Konumun dilidir. Oluşturma sırasında ayarlanır ve güncellenemez.

store_code

string

İsteğe bağlı. Bu konumun belirli bir hesapta benzersiz olması gereken harici tanımlayıcı. Bu, konumu kendi kayıtlarınızla ilişkilendirmenin bir yoludur.

title

string

Zorunlu. Konum adı; mağazanızda, web sitenizde ve belgelerinizde düzenli olarak kullanıldığı ve müşteriler tarafından bilinen, işletmenizin gerçek dünyadaki adını yansıtmalıdır. Gerektiğinde ek bilgiler kaynağın diğer alanlarına eklenebilir (örneğin, Address, Categories). Adınıza gereksiz bilgiler eklemeyin (örneğin, "Google Inc. - Mountain View Şirket Merkezi" yerine "Google" ifadesini tercih edin). Pazarlama kısa açıklamaları, mağaza kodları, özel karakterler, çalışma saatleri veya kapalı/açık olma durumu, telefon numaraları, web sitesi URL'leri, hizmet/ürün bilgileri, konum/adres veya yol tarifleri ya da çevre bilgileri (örneğin, "Duane Reade'deki Chase ATM").

phone_numbers

PhoneNumbers

İsteğe bağlı. Müşterilerin işletmeyle iletişime geçmek için kullanabileceği farklı telefon numaraları.

categories

Categories

İsteğe bağlı. İşletmeyi tanımlayan farklı kategoriler.

storefront_address

PostalAddress

İsteğe bağlı. İşletmenizin konumunu açıklayan kesin ve doğru bir adres. Uzak yerlerde bulunan posta kutuları veya posta kutuları kabul edilmez. Şu anda adreste en fazla beş address_lines değeri belirtebilirsiniz. Bu alan yalnızca mağazası olan işletmeler için ayarlanmalıdır. Bu alan, CUSTOMER_LOCATION_ONLY türündeki konumlar için ayarlanmamalıdır, ancak ayarlanırsa sağlanan tüm değerler silinir.

website_uri

string

İsteğe bağlı. Bu işletmenin URL'si. Mümkünse tüm konumları veya markayı temsil eden genel bir web sitesi/URL yerine işletmenin ilgili konumunu temsil eden bir URL kullanın.

regular_hours

BusinessHours

İsteğe bağlı. İşletmenin çalışma saatleri.

special_hours

SpecialHours

İsteğe bağlı. İşletmeye özel çalışma saatleri. Buna genellikle tatil günlerindeki çalışma saatleri ve normal çalışma saatleri dışındaki zamanlar dahildir. Bunlar, normal çalışma saatlerini geçersiz kılar. Bu alan, normal çalışma saatleri olmadan ayarlanamaz.

service_area

ServiceAreaBusiness

İsteğe bağlı. Hizmet bölgesi işletmeleri, hizmetlerini müşterinin bulunduğu yerde sağlar. Bu işletme bir hizmet bölgesi işletmesiyse bu alan, işletmenin hizmet verdiği bölgeleri açıklar.

labels[]

string

İsteğe bağlı. İşletmenizi etiketlemenize olanak tanıyan, serbest biçimli dizelerden oluşan bir koleksiyon. Bu etiketler kullanıcılara yönelik DEĞİLDİR; onları yalnızca siz görebilirsiniz. Etiket başına 1-255 karakter arasında olmalıdır.

ad_words_location_extensions

AdWordsLocationExtensions

İsteğe bağlı. AdWords'de gösterilen ek bilgiler.

latlng

LatLng

İsteğe bağlı. Kullanıcı tarafından sağlanan enlem ve boylam. Bir konum oluşturulurken, sağlanan adresin coğrafi kodları başarıyla kodlanırsa bu alan yoksayılır. Bu alan yalnızca kullanıcı tarafından sağlanan latlng değeri oluşturma sırasında kabul edildiyse veya latlng değeri Google İşletme Profili web sitesi aracılığıyla güncellendiyse alma isteklerinde döndürülür. Bu alan yalnızca onaylanmış müşteriler tarafından güncellenebilir.

open_info

OpenInfo

İsteğe bağlı. Konumun o anda açık olup olmadığını gösteren bir işaret.

metadata

Metadata

Yalnızca çıkış. Kullanıcı tarafından düzenlenemeyen ek bilgiler.

profile

Profile

İsteğe bağlı. İşletmenizi kendi ifadenizle anlatır ve işletmenizin benzersiz hikayesini ve tekliflerinizi kullanıcılarla paylaşır.

Bu alan, konaklama kategorileri (ör. oteller, moteller, oteller) hariç tüm kategoriler için zorunludur.

relationship_data

RelationshipData

İsteğe bağlı. Bununla ilgili tüm konumlar ve zincir.

more_hours[]

MoreHours

İsteğe bağlı. Bir işletmenin farklı departmanları veya belirli müşterileri için daha fazla çalışma saati.

service_items[]

ServiceItem

İsteğe bağlı. Satıcılar tarafından desteklenen hizmetlerin listesi. Hizmet, saç kesimi, şofben montajı vb. olabilir. Yinelenen hizmet öğeleri otomatik olarak kaldırılır.

Meta veri

Konumla ilgili olarak kullanıcılar tarafından düzenlenemeyen ek bilgiler.

Alanlar
has_google_updated

bool

Yalnızca çıkış. Bu konumla ilişkili yer kimliğinin istemci tarafından güncellenmesi veya reddedilmesi gereken güncellemeler olup olmadığını belirtir. Bu boole ayarlanırsa doğrulanması gereken bilgileri aramak için getGoogleUpdated yöntemini çağırmanız gerekir.

has_pending_edits

bool

Yalnızca çıkış. Bu Konum'un özelliklerinden herhangi birinin düzenleme bekleme durumunda olup olmadığını belirtir.

can_delete

bool

Yalnızca çıkış. Konumun API kullanılarak silinip silinemeyeceğini belirtir.

can_operate_local_post

bool

Yalnızca çıkış. Girişin yerel yayınları yönetip yönetemeyeceğini belirtir.

can_modify_service_list

bool

Yalnızca çıkış. Girişin, hizmet listesini değiştirip değiştiremeyeceğini gösterir.

can_have_food_menus

bool

Yalnızca çıkış. Girişin yemek menüsü için uygun olup olmadığını gösterir.

can_operate_health_data

bool

Yalnızca çıkış. Konumun, sağlık verileri üzerinde çalışıp çalışamayacağını belirtir.

can_operate_lodging_data

bool

Yalnızca çıkış. Konumun Konaklama verileri üzerinde kullanılıp kullanılamayacağını belirtir.

place_id

string

Yalnızca çıkış. Bu konum Google Haritalar'da görünüyorsa bu alan konumun yer kimliğiyle doldurulur. Bu kimlik çeşitli Places API'lerinde kullanılabilir.

Bu alan, "Oluşturma" çağrıları sırasında ayarlanabilir ancak Güncelleme için ayarlanamaz.

duplicate_location

string

Yalnızca çıkış. Bu konumun çoğaltıldığı konum kaynağı.

maps_uri

string

Yalnızca çıkış. Haritalar'da konumun bağlantısı.

new_review_uri

string

Yalnızca çıkış. Müşterilerin konumla ilgili yorum bırakabileceği Google Arama sayfasına bağlantı.

can_have_business_calls

bool

Yalnızca çıkış. Girişin işletme aramaları için uygun olup olmadığını gösterir.

has_voice_of_merchant

bool

Yalnızca çıkış. Girişte Satıcının Sesi olup olmadığını belirtir. Bu boole değeri yanlışsa, Voice of Merchant'ı neden almadıklarıyla ilgili ayrıntıları öğrenmek için locations.getVoiceOfMerchantState API'sini çağırmanız gerekir.

MoreHours

Bir konumun belirli işletme türleri için açık olduğu dönemler.

Alanlar
hours_type_id

string

Zorunlu. Saat türü. Müşteriler, bulundukları konumların kategorileri için desteklenen saat türlerini öğrenmek üzere {#link businessCategory:BatchGet} numaralı telefonu aramalıdır.

periods[]

TimePeriod

Zorunlu. Bu konumun açık olduğu saatlerin koleksiyonu. Her dönem, konumun hafta içinde açık olduğu saat aralığını temsil eder.

MoreHoursType

Bir işletmenin normal çalışma saatlerinin yanı sıra sunabileceği diğer çalışma saati türleri.

Alanlar
hours_type_id

string

Yalnızca çıkış. Bu saat türü için Google tarafından sağlanan sabit bir kimlik.

display_name

string

Yalnızca çıkış. Saat türü için okunabilir İngilizce görünen addır.

localized_display_name

string

Yalnızca çıkış. Saat türü için kullanıcılar tarafından okunabilen yerelleştirilmiş görünen ad.

OpenInfo

İşletmenin açılış durumuyla ilgili bilgiler.

Alanlar
status

OpenForBusiness

Zorunlu. Konumun şu anda açık olup olmadığını gösterir. Kapalı olacak şekilde güncellenmediği sürece tüm konumlar varsayılan olarak açıktır.

can_reopen

bool

Yalnızca çıkış. Bu işletmenin yeniden açılmaya uygun olup olmadığını belirtir.

opening_date

Date

İsteğe bağlı. Konumun ilk açıldığı tarih. Tam gün bilinmiyorsa yalnızca ay ve yıl sağlanabilir. Tarih, geçmişte olmalı veya bir yıldan ileride olmamalıdır.

OpenForBusiness

Bir konumun durumunu gösterir.

Sıralamalar
OPEN_FOR_BUSINESS_UNSPECIFIED Belirtilmedi.
OPEN Konumun açık olduğunu gösterir.
CLOSED_PERMANENTLY Konumun kalıcı olarak kapandığını gösterir.
CLOSED_TEMPORARILY Konumun geçici olarak kapatıldığını belirtir.

PhoneNumbers

İşletmeye ait telefon numaraları koleksiyonu. Güncellemeler sırasında her iki alan da ayarlanmalıdır. Müşteriler, güncelleme maskesini kullanarak yalnızca birincil veya ek telefon numaralarını güncelleyemez. "+1 415 555 0132" gibi uluslararası telefon biçimi tercih edilir. Daha fazla bilgiyi (https://developers.google.com/style/phone-numbers#international-phone-numbers) adresinde bulabilirsiniz.

Alanlar
primary_phone

string

Zorunlu. Bağımsız işletmenizin konumuna mümkün olduğunca doğrudan bağlanan bir telefon numarası. Mümkün olduğunda çağrı merkezi yardım hattı numarası yerine yerel telefon numarası kullanın.

additional_phones[]

string

İsteğe bağlı. Birincil telefon numaranıza ek olarak işletmenizin aranabileceği en fazla iki telefon numarası (cep telefonu veya sabit hat olabilir, faks numarası olamaz).

PlaceInfo

Yer kimliğiyle temsil edilen bir alanı tanımlar.

Alanlar
place_name

string

Zorunlu. Yerin yerelleştirilmiş adı. Örneğin, Scottsdale, AZ.

place_id

string

Zorunlu. Yerin kimliği. Bir bölgeye karşılık gelmelidir. (https://developers.google.com/places/web-service/supported_types#table3)

Yerler

Bir yer kümesiyle temsil edilen alanların birleşimini tanımlar.

Alanlar
place_infos[]

PlaceInfo

Yer kimlikleriyle temsil edilen alanlar. En fazla 20 yerle sınırlıdır.

Profil

Konumun profiliyle ilgili tüm bilgiler.

Alanlar
description

string

Zorunlu. Konumun açıklamasını kendi sesinizle yapabilir, başkası tarafından düzenleyemezsiniz.

RelationshipData

Bununla ilgili tüm ebeveyn ve alt konumların bilgileri.

Alanlar
parent_location

RelevantLocation

Bu konumun ilişkili olduğu üst konum.

children_locations[]

RelevantLocation

Bu konumun ilişkili olduğu alt konumların listesi.

parent_chain

string

Bu konumun üyesi olduğu Zincirin kaynak adı. [Zincir kimliği nasıl bulunur?] [Locations.SearchChains]

RelevantLocation

Mevcut konumla ilgili başka bir konum hakkında bilgiler. İlişki, DEPARTMENT_OF veya INDEPENDENT_ESTABLISHMENT_OF özelliklerinden herhangi biri olabilir ve burada belirtilen konum, konumun her iki tarafında da (üst/alt) olabilir.

Alanlar
place_id

string

Zorunlu. İlişkinin diğer tarafındaki konumu yer kimliğiyle belirtin.

relation_type

RelationType

Zorunlu. İlişkinin türü.

RelationType

Belirtilecek tür ilişkileri.

Sıralamalar
RELATION_TYPE_UNSPECIFIED Tür belirtilmedi.
DEPARTMENT_OF Bu, bir fiziksel alanı paylaşan, aynı markayı/üst yönetimi/kuruluşu ancak mağaza çalışma saatleri veya telefon numaraları gibi farklı temel özelliklere sahip 2 konum arasındaki ilişkiyi temsil eder. Örneğin, Kocaeli Eczanesi, Migros'un Toptan Satışı'nda bir bölümdür.
INDEPENDENT_ESTABLISHMENT_IN Bu, iki konumun aynı fiziksel konumda aynı anda farklı şirketlere ait olduğu ancak farklı şirketlere ait olduğu durumları temsil eder (ör. Starbucks, bir alışveriş merkezindeki Starbucks).

RepeatedEnumAttributeValue

value_type değeri REPEATED_ENUM olan bir özelliğin değerleri. Bu, iki değer kimliği listesinden oluşur: ayarlananlar (doğru) ve ayarlanmamış olanlar (yanlış). Eksik değerler bilinmeyen olarak kabul edilir. En az bir değer belirtilmelidir.

Alanlar
set_values[]

string

Ayarlanan enum değerleri.

unset_values[]

string

Ayarlanmamış sıralama değerleri.

SearchChainsRequest

Konumlar.SearchChains için istek mesajı

Alanlar
chain_name

string

Zorunlu. Adını kullanarak bir zinciri arayın. Tam/kısmi/kesinti/ilgili sorgular desteklenir. Örnekler: "valilik", "gec-mart", "merkez", "沃尔玛"

page_size

int32

Bu sorgudan döndürülecek maksimum eşleşen zincir sayısı. Varsayılan değer 10'dur. Olası maksimum değer 500'dür.

SearchChainsResponse

Konumlar.SearchChains için yanıt mesajı

Alanlar
chains[]

Chain

SearchChainsRequest'te sorgulananChain_display_name ile eşleşen zincirler. Eşleşme olmazsa bu alan boş olur. Sonuçlar, alaka düzeyine göre listelenir.

SearchGoogleLocationsRequest

GoogleLocations.SearchGoogleLocations için istek iletisi.

Alanlar
page_size

int32

Döndürülecek eşleşme sayısı. Varsayılan değer 3, maksimum 10'dur. Daha fazla veri istenirse gecikmenin artabileceğini unutmayın. Sayfalara ayırma işlemi yapılmaz.

Birleştirme alanı search_query. Arama sorgusu. Bu, bir konum nesnesi veya bir dize sorgusu olarak sağlanabilir. search_query şunlardan yalnızca biri olabilir:
location

Location

Aranacak konum. Sağlanmışsa, sağlanan konum ayrıntılarıyla eşleşen konumları bulur.

query

string

Aranacak metin sorgusu. Bir sorgu dizesinden elde edilen arama sonuçları, tam konum sağlamaya kıyasla daha az doğru olur, ancak daha fazla tam olmayan eşleşme sağlayabilir.

SearchGoogleLocationsResponse

GoogleLocations.SearchGoogleLocations için yanıt iletisi.

Alanlar
google_locations[]

GoogleLocation

Belirtilen istekle eşleşme olasılığı yüksek olan, doğruluk oranı en yüksek olandan en az olana doğru sıralanmış GoogleLocations koleksiyonu.

ServiceAreaBusiness

Hizmet bölgesi işletmeleri, hizmetlerini müşterilerin bulunduğu yerde (ör. çilingir veya tesisatçı) sunar.

Alanlar
business_type

BusinessType

Zorunlu. [type] türünü gösterir hizmet bölgesi işletmesinin [google.mybusiness.businessinfo.v1.ServiceAreaBusiness.BusinessType].

places

Places

Bu işletmenin hizmet verdiği bölge, bir dizi yerle tanımlanır.

region_code

string

Sabit. Bu hizmet bölgesi işletmesinin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Ayrıntılar için http://cldr.unicode.org/ ve http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: "CH" kullanmaya başladım.

Bu alan, CUSTOMER_LOCATION_ONLY işletmeleri için gereklidir, aksi takdirde yoksayılır.

Burada belirtilen bölge, bu işletmenin hizmet verdiği bölgelere ait bölgelerden farklı olabilir (ör. bulunduğu bölge dışındaki bölgelerde hizmet veren hizmet bölgesi işletmeleri).

Bu konum, oluşturulduktan sonra doğrulama gerektiriyorsa doğrulama amacıyla sağlanan adres bu bölgede bulunmalıdır ve işletme sahibi ya da yetkili temsilcisi, belirtilen doğrulama adresinden posta alabiliyor olmalıdır.

BusinessType

Bu işletmenin yalnızca müşteri konumunda (ör. çekici kamyonu) yoksa hem adreste hem de işletme yerinde mi (ör. yemek alanı bulunan ve aynı zamanda müşterilere teslimat yapan pizzacı) hizmet sunduğunu belirtir.

Sıralamalar
BUSINESS_TYPE_UNSPECIFIED Yalnızca çıkış. Belirtilmedi.
CUSTOMER_LOCATION_ONLY Yalnızca bulunduğu bölgenin yakınında (işletme adresinde değil) hizmet sunuyor. Bir işletme, CUSTOMER_AND_BUSINESS_LOCATION yerine CUSTOMER_LOCATION_ONLY olarak güncelleniyorsa konum güncellemesinde storefront_address alan maskesi bulunmalı ve alan boş olarak ayarlanmalıdır.
CUSTOMER_AND_BUSINESS_LOCATION İşletme adresinde ve yakınında hizmet verir.

ServiceItem

Tek bir hizmet öğesini açıklayan mesaj. Satıcının sunduğu hizmet türünü tanımlamak için kullanılır. Örneğin, saç kesimi bir hizmet olabilir.

Alanlar
price

Money

İsteğe bağlı. Hizmet öğesinin parasal fiyatını temsil eder. Fiyat eklenirken para_kodu ve birimlerin ayarlanmasını öneririz. Bu, hizmet öğesinin sabit fiyatı olarak değerlendirilir.

Birleştirme alanı service_item_info. Aşağıdaki alanlardan biri her zaman ayarlanmalıdır. service_item_info şunlardan yalnızca biri olabilir:
structured_service_item

StructuredServiceItem

İsteğe bağlı. Bu alan, yapılandırılmış hizmet verileri için büyük/küçük harfe ayarlanır.

free_form_service_item

FreeFormServiceItem

İsteğe bağlı. Bu alan, serbest biçimli hizmet verileri için büyük/küçük harfe ayarlanır.

FreeFormServiceItem

Satıcı tarafından sunulan serbest biçimli bir hizmeti temsil eder. Bunlar, yapı hizmet verilerimizin bir parçası olarak kullanıma sunulmayan hizmetlerdir. Satıcı, coğrafi satıcı platformu aracılığıyla bu tür hizmetlerin adlarını manuel olarak girer.

Alanlar
category

string

Zorunlu. Bu alan, kategori adını (kategorinin sabit kimliği) temsil eder. category ve service_type_id, Category mesajında belirtilen olası kombinasyonlarla eşleşmelidir.

label

Label

Zorunlu. Öğe için dil etiketli etiketler. Öğe adlarının 140 karakter veya daha kısa, açıklamaların ise 250 karakter veya daha kısa olmasını öneririz. Bu alan yalnızca giriş özel bir hizmet öğesiyse ayarlanmalıdır. Standartlaştırılmış hizmet türleri service_type_id aracılığıyla güncellenmelidir.

StructuredServiceItem

Satıcı tarafından sunulan yapılandırılmış bir hizmeti temsil eder. Ör. toilet_installation.

Alanlar
service_type_id

string

Zorunlu. service_type_id alanı, ServiceType adresinde bulunabilen, Google tarafından sağlanan benzersiz bir kimliktir. Bu bilgi BatchGetCategories Rpc hizmeti tarafından sağlanmaktadır.

description

string

İsteğe bağlı. Yapılandırılmış hizmet öğesinin açıklaması. Karakter sınırı 300'dür.

ServiceType

İşletmenin sunduğu bir hizmet türünü açıklayan mesaj.

Alanlar
service_type_id

string

Yalnızca çıkış. Bu hizmet türü için sabit bir kimlik (Google tarafından sağlanır).

display_name

string

Yalnızca çıkış. Hizmet türü için okunabilir görünen addır.

SpecialHourPeriod

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu tek bir dönemi temsil eder. Özel çalışma saatleri, 24 saatten kısa bir aralığı temsil etmelidir. open_time ve start_date, close_time ve end_date tarihinden önce olmalıdır. close_time ve end_date, belirtilen start_date değerinden sonraki günde 11:59'a kadar uzayabilir. Örneğin, aşağıdaki girişler geçerlidir:

start_date=2015-11-23, open_time=08:00, close_time=18:00
start_date=2015-11-23, end_date=2015-11-23, open_time=08:00,
close_time=18:00 start_date=2015-11-23, end_date=2015-11-24,
open_time=13:00, close_time=11:59

Aşağıdaki girişler geçerli değil:

start_date=2015-11-23, open_time=13:00, close_time=11:59
start_date=2015-11-23, end_date=2015-11-24, open_time=13:00,
close_time=12:00 start_date=2015-11-23, end_date=2015-11-25,
open_time=08:00, close_time=18:00
Alanlar
start_date

Date

Zorunlu. Bu özel saat döneminin başladığı takvim tarihi.

open_time

TimeOfDay

İsteğe bağlı. Geçerli değerler 00:00-24:00'dır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false (yanlış) değerine ayarlanmışsa bu değer belirtilmelidir.

end_date

Date

İsteğe bağlı. Bu özel saatlik dönemin sona erdiği takvim tarihi. end_date alanı ayarlanmazsa start_date alanında belirtilen tarih varsayılan olarak ayarlanır. Ayarlanırsa bu alan, start_date değerine eşit veya ondan en fazla 1 gün sonra olmalıdır.

close_time

TimeOfDay

İsteğe bağlı. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder. closed false (yanlış) değerine ayarlanmışsa bu değer belirtilmelidir.

closed

bool

İsteğe bağlı. Doğru değerine ayarlanırsa end_date, open_time ve close_time yoksayılır ve start_date içinde belirtilen tarih, tüm gün boyunca kapalı konum olarak kabul edilir.

SpecialHours

Bir konumun çalışma saatlerinin normal çalışma saatlerinden farklı olduğu dönemleri ifade eder.

Alanlar
special_hour_periods[]

SpecialHourPeriod

Zorunlu. İşletmenin normal çalışma saatleriyle ilgili istisnaların listesi.

TimePeriod

Belirtilen açılış gününde/saatinde başlayıp belirtilen kapanış gününde/saatinde kapanan, işletmenin açık olduğu zaman aralığını temsil eder. Kapanış saati, açılış saatinden sonra olmalıdır; örneğin, aynı günün ilerleyen saatlerinde veya sonraki bir günde.

Alanlar
open_day

DayOfWeek

Zorunlu. Bu dönemin başlayacağı day of the week değerini gösterir.

open_time

TimeOfDay

Zorunlu. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.

close_day

DayOfWeek

Zorunlu. Bu dönemin sona erdiği day of the week değerini gösterir.

close_time

TimeOfDay

Zorunlu. Geçerli değerler 00:00-24:00 arasındadır; burada 24:00, belirtilen gün alanının sonundaki gece yarısını temsil eder.

UpdateAttributesRequest

AttributesService.UpdateAttributes isteği.

Alanlar
attributes

Attributes

Güncellenmesi gereken bir özellik koleksiyonu.

attribute_mask

FieldMask

Zorunlu. Güncellemek istediğiniz özelliklerin özellik adı. attributes/{attribute} tarafından temsil ediliyor.

Güncellemeler: Güncellemek istediğiniz özellikler alanında sağlanan tüm özellikler attribute_mask alanında ayarlanmalıdır. Yukarıdaki listede belirtilen ancak attribute_mask alanında bulunmayan özellikler yoksayılır.

Silme: Belirli özellikleri silmek istiyorsanız, özelliklerin attribute_mask içinde, özellikler listesinde eşleşen bir giriş olmadan belirtilmesi gerekir. Bir konum için ayarlanmış tüm özellikleri silmek isterseniz konum için geçerli olan tüm özellikleri aramanız ve ardından bunları attribute_mask özelliğine boş bir özellikler alanıyla eklemeniz gerekir.

UpdateLocationRequest

Konumlar.UpdateLocation için mesaj iste.

Alanlar
location

Location

Zorunlu. Güncellenen konum bilgileri.

update_mask

FieldMask

Zorunlu. Güncellenecek belirli alanlar.

validate_only

bool

İsteğe bağlı. True (doğru) ise istek, konum gerçekten güncellenmeden doğrulanır. Bu alan ayarlandığında, yalnızca varsa doğrulama hataları döndürürüz. Hata bulunmazsa yanıt boş olur.

UriAttributeValue

value_type URL'sine sahip bir özelliğin değerleri.

Alanlar
uri

string

Zorunlu. Bu özellik için önerilen URI değeri.