- Kaynak: Hesap
- AccountType
- AccountRole
- VerificationState
- VettedState
- PermissionLevel
- OrganizationInfo
- PostalAddress
- Yöntemler
Kaynak: Hesap
Hesap, konumunuz için bir kapsayıcıdır. İşletmeniz için konumları yöneten tek kullanıcı sizseniz kişisel Google Hesabınızı kullanabilirsiniz. Konumların yönetimini birden çok kullanıcıyla paylaşmak için bir işletme hesabı oluşturun.
JSON gösterimi |
---|
{ "name": string, "accountName": string, "primaryOwner": string, "type": enum ( |
Alanlar | |
---|---|
name |
Sabit. |
accountName |
Zorunlu. Hesabın adı. |
primaryOwner |
Zorunlu. Yalnızca giriş. Oluşturulan hesabın birincil sahibi olacak hesabın kaynak adı. Hedef, |
type |
Zorunlu. Hesap türünü içerir. Bu API kullanılarak PERSONAL ve Kuruluş türündeki hesaplar oluşturulamaz. |
role |
Yalnızca çıkış. Bu hesabın AccountRole değerini belirtir. |
verificationState |
Yalnızca çıkış. Doğrulanırsa, gelecekte oluşturulacak konumlar otomatik olarak Google Haritalar'a bağlanır ve denetleme gerektirmeden Google+ sayfaları oluşturulur. |
vettedState |
Yalnızca çıkış. Hesabın Google tarafından incelenip incelenmediğini belirtir. Doğrulanmış hesaplar, VETTED_PARTNER yöntemi aracılığıyla konumları doğrulayabilir. |
accountNumber |
Yalnızca çıkış. Temel hazırlığı yapıldıysa hesap referans numarası. |
permissionLevel |
Yalnızca çıkış. Kullanıcının bu hesap için sahip olduğu izin düzeyini belirtir. |
organizationInfo |
Yalnızca çıkış. Kuruluşla ilgili ek bilgiler. Bu alan yalnızca kurumsal hesap için doldurulur. |
AccountType
Bunun ne tür bir hesap olduğunu belirtir: kişisel/kullanıcı hesabı veya işletme hesabı.
Sıralamalar | |
---|---|
ACCOUNT_TYPE_UNSPECIFIED |
Belirtilmedi. |
PERSONAL |
Son kullanıcı hesabı. |
LOCATION_GROUP |
Konum grubu. Daha fazla bilgi için yardım merkezi makalesini inceleyin |
USER_GROUP |
Kurum personelini gruplar halinde ayırmak için bir Kullanıcı Grubu. Daha fazla bilgi için yardım merkezi makalesini inceleyin |
ORGANIZATION |
Bir şirketi temsil eden kuruluş. Daha fazla bilgi için yardım merkezi makalesini inceleyin |
AccountRole
Kimliği doğrulanan kullanıcının bu hesap için sahip olduğu erişim düzeyini belirtir. Daha fazla bilgi için yardım merkezi makalesini inceleyin
Sıralamalar | |
---|---|
ACCOUNT_ROLE_UNSPECIFIED |
Belirtilmedi. |
PRIMARY_OWNER |
Kullanıcı, bu hesabın birincil sahibidir. |
OWNER |
Hesabın kullanıcı sahibi. |
MANAGER |
Kullanıcı bu hesabı yönetebilir. |
SITE_MANAGER |
Kullanıcı, hesaba ait sınırlı bir özellik grubunu yönetebilir. |
VerificationState
Hesabın doğrulama durumunu belirtir.
Sıralamalar | |
---|---|
VERIFICATION_STATE_UNSPECIFIED |
Belirtilmedi. |
VERIFIED |
Doğrulanmış hesap. |
UNVERIFIED |
Doğrulanmamış hesap ve doğrulama isteğinde bulunulmadı. |
VERIFICATION_REQUESTED |
Doğrulanmamış ancak doğrulama isteğinde bulunulan hesap. |
VettedState
Hesabın incelenme durumunu gösterir.
Sıralamalar | |
---|---|
VETTED_STATE_UNSPECIFIED |
Belirtilmedi |
NOT_VETTED |
Hesap, Google tarafından incelenmemiştir. |
VETTED |
Hesap, Google tarafından onaylanmış ve geçerli bir durumdadır. Doğrulanmış bir grup hesabına doğrudan erişimi olan hesaplar otomatik olarak incelenir. |
INVALID |
Hesap incelendi ancak geçersiz durumda. Hesap, incelenmemiş bir hesap gibi davranır. |
PermissionLevel
Kimliği doğrulanan kullanıcının bu hesap için sahip olduğu erişim düzeyini belirtir.
Sıralamalar | |
---|---|
PERMISSION_LEVEL_UNSPECIFIED |
Belirtilmedi. |
OWNER_LEVEL |
Kullanıcının sahip düzeyinde izni var. |
MEMBER_LEVEL |
Kullanıcı, üye düzeyinde izne sahip. |
OrganizationInfo
Kuruluş için depolanan ek bilgiler.
JSON gösterimi |
---|
{
"registeredDomain": string,
"address": {
object ( |
Alanlar | |
---|---|
registeredDomain |
Yalnızca çıkış. Hesabın kayıtlı alanı. |
address |
Yalnızca çıkış. Hesabın posta adresi. |
phoneNumber |
Yalnızca çıkış. Kuruluşun iletişim numarası. |
PostalAddress
Bir posta adresini temsil eder (ör. posta teslimatı veya ödeme adresleri için). Bir posta adresi belirtildiğinde posta hizmeti, öğeleri posta kutusu veya benzeri bir yere teslim edebilir. Coğrafi konumları (yollar, şehirler, dağlar) modellemek için tasarlanmamıştır.
Tipik kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi veya mevcut verilerin içe aktarılması yoluyla oluşturulur.
Adres girme / düzenleme ile ilgili öneriler: - https://github.com/google/libaddressinput gibi uluslararası kullanıma hazır bir adres widget'ı kullanın) - Bu alanın kullanıldığı ülkelerin dışındaki alanlarda giriş veya düzenleme işlemleri için kullanıcılara kullanıcı arayüzü öğeleri sunulmamalıdır.
Bu şemanın nasıl kullanılacağı hakkında daha fazla yardım için lütfen bkz. https://support.google.com/business/answer/6397478
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 |
Tüm yeni düzeltmeler eski düzeltmelerle geriye dönük olarak uyumlu olmalıdır. |
regionCode |
Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu hiçbir zaman tahmin edilmez ve değerin doğru olduğundan emin olmak kullanıcıya bağlıdır. Ayrıntılı bilgi için https://cldr.unicode.org/ ve https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html sayfalarına göz atın. Örnek: İsviçre için "CH". |
languageCode |
İ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 ya da harf çevirisiyle eşleştirilmiş dille eşleşmesi beklenir. Bu durum belirli ülkelerde biçimlendirmeyi etkileyebilir. Ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez. Bu değer bilinmiyorsa yanlış olması muhtemel bir varsayılan değeri belirtmek yerine atlanmalıdır. Örnekler: "zh-Hant", "ja", "ja-Latn", "en". |
postalCode |
İsteğe bağlı. Adresin posta kodu. Bazı ülkeler, posta kodlarını kullanmaz veya zorunlu kılmaz ancak posta kodlarının kullanıldığı yerlerde adresin diğer bölümleriyle ek doğrulama işlemini tetikleyebilir (ör. ABD'de eyalet/posta kodu doğrulaması). |
sortingCode |
İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu özellik çoğu bölgede kullanılmaz. Kullanıldığı yerlerde bu değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya sadece "sektör kodu" (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili) temsil eden bir sayıdır. |
administrativeArea |
İsteğe bağlı. Bir ülkenin veya bölgenin posta adresleri için kullanılan en yüksek idari alt bölüm. Örneğin bu bir eyalet, il, oblast veya vilayet olabilir. Daha açık belirtmek gerekirse, İspanya için bu, özerk topluluk değil, ilçedir (ör. "Katalonya" değil, "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Örneğin, İsviçre'de bu alan boş bırakılmalıdır. |
locality |
İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT topluluğu, Birleşik Krallık posta şehri. Dünyada, yerelliklerin iyi tanımlanmadığı veya bu yapıya tam olarak uymadığı bölgelerde yerelliği boş bırakın ve addressLines'ı kullanın. |
sublocality |
İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir. |
addressLines[] |
Bir adresin daha alt düzeylerini açıklayan yapılandırılmamış adres satırları. addressLines'daki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer içerebileceğinden (ör. "Austin, TX"), satır sırasının açık olması önemlidir. Adres satırlarının sırası, adresin ülkesi/bölgesi için "zarf siparişi" olmalıdır. Bunun değişiklik gösterebileceği yerlerde (ör. Japonya), address_language ifadesini açıkça belirtmek için kullanılır (örneğin, büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" veya "en"). Bu şekilde, adresin en belirgin satırı dile göre seçilebilir. Bir adresin izin verilen minimum yapısal gösterimi, geri kalan tüm bilgilerin adres satırlarına yerleştirildiği bir AreaCode'dan oluşur. Böyle bir adresi coğrafi kodlama olmadan yaklaşık olarak biçimlendirmek mümkün olsa da, en azından kısmen çözümlenene kadar adres bileşenlerinin hiçbiri hakkında anlamsal akıl yürütme yapılamaz. Yalnızca AreaCode ve addressLines içeren bir adres oluşturduğunuzda (adresin hangi bölümlerinin yerel konumlar veya idari alanlar olması gerektiğini tahmin etmek yerine) tamamen yapılandırılmamış adreslerin işlenmesi için önerilen yöntem coğrafi kodlamadır. |
recipients[] |
İsteğe bağlı. Adresteki alıcı. Bu alan, belirli koşullar altında çok satırlı bilgiler içerebilir. Örneğin, "bakımı" bilgileri içerebilir. |
organization |
İsteğe bağlı. Adresteki kuruluşun adı. |
Yöntemler |
|
---|---|
|
Belirtilen üst öğe altında belirtilen ad ve türle bir hesap oluşturur. |
|
Belirtilen hesabı alır. |
|
Kimliği doğrulanmış kullanıcının tüm hesaplarını listeler. |
|
Belirtilen işletme hesabını günceller. |