REST Resource: accounts.businessInfo

Kaynak: BusinessInfo

BusinessInfo mesajı, satıcının işletmesiyle ilgili önemli bilgileri içerir.

Bu mesajda fiziksel adres, müşteri hizmetleri iletişim bilgileri ve bölgeye özgü tanımlayıcılar gibi önemli işletme ayrıntıları yer alır.

JSON gösterimi 
{
  "name": string,
  "address": {
    object (PostalAddress)
  },
  "phone": {
    object (PhoneNumber)
  },
  "phoneVerificationState": enum (PhoneVerificationState),
  "customerService": {
    object (CustomerService)
  },
  "koreanBusinessRegistrationNumber": string
}
Alanlar
name

string

Tanımlayıcı. İşletme bilgilerinin kaynak adı. Biçim: accounts/{account}/businessInfo
address

object (PostalAddress)

İsteğe bağlı. İşletmenin adresi. Yalnızca regionCode, addressLines, postalCode, administrativeArea ve locality alanları desteklenir. Diğer tüm alanlar yoksayılır.
phone

object (PhoneNumber)

Yalnızca çıkış. İşletmenin telefon numarası.
phoneVerificationState

enum (PhoneVerificationState)

Yalnızca çıkış. İşletmenin telefon doğrulama durumu.
customerService

object (CustomerService)

İsteğe bağlı. İşletmenin müşteri hizmetleri.
koreanBusinessRegistrationNumber

string

İsteğe bağlı. XXX-XX-XXXXX biçiminde kısa çizgiyle ayrılmış 10 haneli Kore işletme tescil numarası.

PostalAddress

Posta adresini temsil eder. Örneğin, posta teslimatı veya ödeme adresleri için. Posta hizmetleri, posta adresi verilen bir tesise, posta kutusuna veya benzeri bir yere ürün teslim edebilir. Coğrafi konumları (yollar, kasabalar, dağlar) modellemek için tasarlanmamıştır.

Normal kullanımda, adresler işlem türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılmasıyla oluşturulur.

Adres girişi / düzenlemeyle ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın. - Kullanıcılara, ilgili alanın kullanıldığı ülkeler dışındaki alanların girişi veya düzenlenmesi için kullanıcı arayüzü öğeleri sunulmamalıdır.

Bu şemanın nasıl kullanılacağıyla ilgili daha fazla bilgi için https://support.google.com/business/answer/6397478 adresini ziyaret edin.

JSON gösterimi 
{
  "revision": integer,
  "regionCode": string,
  "languageCode": string,
  "postalCode": string,
  "sortingCode": string,
  "administrativeArea": string,
  "locality": string,
  "sublocality": string,
  "addressLines": [
    string
  ],
  "recipients": [
    string
  ],
  "organization": string
}
Alanlar
revision

integer

PostalAddress öğesinin şema düzeltmesi. Bu, en son düzeltme olan 0 değerine ayarlanmalıdır.

Tüm yeni düzeltmeler, eski düzeltmelerle geriye dönük uyumlu olmalıdır.
regionCode

string

Zorunlu. Adresin bulunduğu ülke/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman çıkarılmaz ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılar için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html adresine bakın. Örnek: İsviçre için "CH".
languageCode

string

İsteğe bağlı. Bu adresin içeriğinin BCP-47 dil kodu (biliniyorsa). Bu, genellikle giriş formunun kullanıcı arayüzü dilidir veya adresin ülkesinde/bölgesinde kullanılan dillerden biriyle veya bunların transkript eşdeğerleriyle eşleşmesi beklenir. Bu durum, belirli ülkelerdeki biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik değildir ve hiçbir zaman doğrulama işlemlerini veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan değer belirtmek yerine atlanmalıdır.

Örnekler: "zh-Hant", "ja", "ja-Latn", "en".
postalCode

string

İsteğe bağlı. Adresin posta kodu. Posta kodları her ülkede kullanılmaz veya zorunlu tutulmaz ancak kullanıldıkları yerlerde adresin diğer bölümleriyle birlikte ek doğrulama tetiklenebilir (ör. ABD'de eyalet/posta kodu doğrulaması).
sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu, çoğu bölgede kullanılmaz. Kullanıldığı yerlerde değer, "CEDEX" gibi bir dizedir ve isteğe bağlı olarak bir sayı (ör. "CEDEX 7") ekler veya "sektör kodu"nu (Jamaika), "teslimat bölgesi göstergesini" (Malavi) ya da "posta ofisi göstergesini" (ör. Fildişi Sahili) temsil eden tek bir sayıdır.
administrativeArea

string

İsteğe bağlı. Bir ülke veya bölgenin posta adresleri için kullanılan en yüksek idari alt birim. Örneğin, bu bir eyalet, il, oblast veya idari bölge olabilir. İspanya'da bu, özerk topluluk değil ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülkede posta adreslerinde idari bölge kullanılmaz. Örneğin İsviçre'de bu alan doldurulmamalıdır.
locality

string

İsteğe bağlı. Genellikle adresin şehir/kasaba kısmını ifade eder. Örnekler: ABD'de şehir, İtalya'da komün, Birleşik Krallık'ta posta bölgesi. Yerelliklerin iyi tanımlanmadığı veya bu yapıya iyi uymadığı dünya bölgelerinde, locality alanını boş bırakın ve addressLines alanını kullanın.
sublocality

string

İsteğe bağlı. Adresin alt mahallesi. Örneğin, mahalleler, ilçeler, semtler bu kapsamdadır.
addressLines[]

string

Bir adresin alt düzeylerini açıklayan yapılandırılmamış adres satırları.

addressLines parametresindeki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden fazla değer içerebileceğinden (ör. "Austin, TX"), satır sırasının net olması önemlidir. Adres satırlarının sırası, adresin bulunduğu ülke/bölge için "zarf sırası" olmalıdır. Bunun değişebileceği yerlerde (ör. Japonya), adres_dili açıkça belirtmek için kullanılır (ör. büyükten küçüğe sıralama için "ja" ve küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu sayede, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal temsili, adres satırlarına yerleştirilen tüm bilgilerin bulunduğu bir regionCode'dan oluşur. Bu tür bir adres, coğrafi kodlama olmadan çok yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözülene kadar adres bileşenlerinin hiçbiri hakkında anlamsal bir çıkarım yapılamaz.

Tamamen yapılandırılmamış adresleri işlemek için önerilen yöntem, yalnızca bir regionCode ve addressLines içeren bir adres oluşturmak ve ardından coğrafi kodlama yapmaktır (adresin hangi bölümlerinin yerel yönetim bölgeleri veya idari bölgeler olması gerektiğini tahmin etmek yerine).
recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlık bilgiler içerebilir. Örneğin, "teslim edilecek kişi" bilgilerini içerebilir.
organization

string

İsteğe bağlı. Adresteki kuruluşun adı.

Telefon Numarası

API kablo biçimi olarak uygun olan, telefon numarasını temsil eden bir nesne.

Bu beyan:

  • "+1 (650) 253-0000 dahili 123" gibi bir telefon numarasının yerel ayara özgü biçimlendirilmesi için kullanılmamalıdır.

  • Verimli depolama için tasarlanmamıştır.

  • numara çevirme için uygun olmayabilir. Bu amaçla numarayı ayrıştırmak için özel kitaplıklar (referanslara bakın) kullanılmalıdır.

Bu sayıyla anlamlı bir işlem yapmak (ör. çeşitli kullanım alanları için biçimlendirmek) için önce i18n.phonenumbers.PhoneNumber nesnesine dönüştürün.

Örneğin, Java'da bu şöyle olur:

com.google.type.PhoneNumber wireProto = com.google.type.PhoneNumber.newBuilder().build(); com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber = PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ"); if (!wireProto.getExtension().isEmpty()) { phoneNumber.setExtension(wireProto.getExtension()); }

Referanslar: - https://github.com/google/libphonenumber

JSON gösterimi 
{
  "extension": string,

  // Union field kind can be only one of the following:
  "e164Number": string,
  "shortCode": {
    object (ShortCode)
  }
  // End of list of possible types for union field kind.
}
Alanlar
extension

string

Telefon numarasının uzantısı. Uzatma, maksimum 40 basamaklı bir sayı dizisi olarak tanımlanması dışında ITU önerilerinde standartlaştırılmamıştır. Burada, rakamlar dışında "," (bekleme) veya "#" gibi bazı numara çevirme karakterleri de saklanabilir.

Şu anda hiçbir bölgede kısa kod içeren uzantılar kullanılmadığından bu alan normalde yalnızca E.164 numarası ile birlikte ayarlanır. Gelecekte kısa kod uzantılarına izin vermek için E.164 numarasından ayrı tutulur.
Birlik alanı kind. Zorunlu. Normal bir numara veya kısa kod. Gelecekte aşağıdaki oneof alanına yeni alanlar eklenebilir. Bu nedenle, istemciler kodladıkları alanların hiçbirinin ayarlanmadığı telefon numaralarını yoksaymalıdır. kind yalnızca aşağıdakilerden biri olabilir:
e164Number

string

Başında artı işareti ("+") bulunan telefon numarası, ardından ülke arama kodu (1 ila 3 haneli) ve abone numarasından oluşan, ek boşluk veya biçimlendirme içermeyen, rahat bir ITU E.164 biçimi kullanan telefon numarası. Örneğin: - doğru: "+15552220123" - yanlış: "+1 (555) 222-01234 x123".

ITU E.164 biçimi, ülke kodunu 12 haneli olarak sınırlar ancak pratikte tüm ülkeler bu sınıra uymaz. Bu nedenle, burada bu kısıtlamayı gevşettik. Yalnızca ülke içi numaralara izin verilmez.

Kaynaklar: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164. - https://en.wikipedia.org/wiki/List_of_country_calling_codes
shortCode

object (ShortCode)

Kısa kod.

Referanslar: - https://en.wikipedia.org/wiki/Short_code

ShortCode

Kısa kodları temsil eden bir nesne. Kısa kod, genellikle normal telefon numaralarından çok daha kısa olan ve MMS ile SMS sistemlerindeki mesajları adreslemek için kullanılabilen bir telefon numarasıdır. Ayrıca kısa kodlar kısa numarayla arama yapmak için de kullanılabilir (ör. "Planınızda kalan dakika sayısını öğrenmek için 611'e kısa mesaj gönderin.").

Kısa kodlar bir bölgeyle sınırlıdır ve uluslararası olarak aranamaz. Bu, aynı kısa kodun farklı bölgelerde, aynı ülke arama kodunu (ör. ABD ve Kanada) paylaşsalar bile farklı kullanım ve fiyatlandırmayla mevcut olabileceği anlamına gelir.

JSON gösterimi 
{
  "regionCode": string,
  "number": string
}
Alanlar
regionCode

string

Zorunlu. Bu kısa koda arama yapılabilen konumun BCP-47 bölge kodu ("US" ve "BB" gibi).

Referanslar: - http://www.unicode.org/reports/tr35/#unicode_region_subtag
number

string

Zorunlu. Başında artı ("+") veya ülke arama kodu olmadan kısa kod basamakları. Örneğin, "611".

PhoneVerificationState

Telefonla doğrulama durumu.

Sıralamalar
PHONE_VERIFICATION_STATE_UNSPECIFIED Varsayılan değer. Bu değer kullanılmamaktadır.
PHONE_VERIFICATION_STATE_VERIFIED Telefon doğrulanmalıdır.
PHONE_VERIFICATION_STATE_UNVERIFIED Telefon doğrulanmadı

CustomerService

Müşteri hizmetleri bilgileri.

JSON gösterimi 
{
  "uri": string,
  "email": string,
  "phone": {
    object (PhoneNumber)
  }
}
Alanlar
uri

string

İsteğe bağlı. Müşteri hizmetlerinin bulunabileceği URI.
email

string

İsteğe bağlı. Müşteri hizmetlerine ulaşılabilecek e-posta adresi.
phone

object (PhoneNumber)

İsteğe bağlı. Müşteri hizmetlerinin aranabileceği telefon numarası.

Yöntemler

getBusinessInfo

 Bir hesabın işletme bilgilerini alır.

updateBusinessInfo

 Bir hesabın işletme bilgilerini günceller.