REST Resource: accounts

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 (AccountType),
  "role": enum (AccountRole),
  "verificationState": enum (VerificationState),
  "vettedState": enum (VettedState),
  "accountNumber": string,
  "permissionLevel": enum (PermissionLevel),
  "organizationInfo": {
    object (OrganizationInfo)
  }
}
Alanlar
name

string

Sabit. accounts/{account_id} biçimindeki kaynak adı.

accountName

string

Zorunlu. Hesabın adı. PERSONAL türündeki bir hesap için bu, kullanıcı hesabının adı ve soyadıdır.

primaryOwner

string

Zorunlu. Yalnızca giriş. Oluşturulan hesabın birincil sahibi olacak hesabın kaynak adı. accounts/{account_id} biçiminde olmalıdır.

type

enum (AccountType)

Zorunlu. Hesap türünü içerir. KİŞİSEL ve Kurum türündeki hesaplar bu API kullanılarak oluşturulamaz.

role

enum (AccountRole)

Yalnızca çıkış. Bu hesabın AccountRole değerini belirtir.

verificationState

enum (VerificationState)

Yalnızca çıkış. Doğrulanırsa, gelecekte oluşturulacak konumlar otomatik olarak Google Haritalar'a bağlanır ve Google+ sayfaları denetleme gerektirmeden oluşturulur.

vettedState

enum (VettedState)

Yalnızca çıkış. Hesabın Google tarafından incelenip incelenmediğini belirtir. Doğrulanmış bir hesap, VETTED_PARTNER yöntemiyle konumları doğrulayabilir.

accountNumber

string

Yalnızca çıkış. Temel hazırlığı yapılmışsa hesap referans numarası.

permissionLevel

enum (PermissionLevel)

Yalnızca çıkış. Kullanıcının bu hesap için sahip olduğu izin düzeyini belirtir.

organizationInfo

object (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 gösterir: kişisel hesap/kullanıcı hesabı mı yoksa işletme hesabı mı?

Sıralamalar
ACCOUNT_TYPE_UNSPECIFIED Belirtilmedi.
PERSONAL Son kullanıcı hesabı.
LOCATION_GROUP Bir Konum grubu. Daha fazla bilgi için yardım merkezi makalesini inceleyin
USER_GROUP Kuruluş personelini gruplar halinde ayırmak için bir Kullanıcı Grubu. Daha fazla bilgi için yardım merkezi makalesini inceleyin
ORGANIZATION Şirketi temsil eden bir 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 sahibi.
OWNER Hesabın kullanıcı sahibi.
MANAGER Kullanıcı bu hesabı yönetebilir.
SITE_MANAGER Kullanıcı, hesap için sınırlı bir grup özelliği yönetebilir.

VerificationState

Hesabın doğrulama durumunu belirtir.

Sıralamalar
VERIFICATION_STATE_UNSPECIFIED Belirtilmedi.
VERIFIED Doğrulanmış hesap.
UNVERIFIED Hesap doğrulanmadı ve doğrulama istenmedi.
VERIFICATION_REQUESTED Doğrulanmamış ancak doğrulama talep edilen hesap.

VettedState

Hesabın incelenmiş durumunu gösterir.

Sıralamalar
VETTED_STATE_UNSPECIFIED Belirtilmedi
NOT_VETTED Hesap, Google tarafından incelenmemiştir.
VETTED Hesap, Google tarafından incelenmiş ve geçerli durumda olmalıdır. Onaylanmış 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ı, sahip düzeyinde izne sahip.
MEMBER_LEVEL Kullanıcı, üye düzeyinde izne sahip.

OrganizationInfo

Bir kuruluş için depolanan ek bilgiler.

JSON gösterimi
{
  "registeredDomain": string,
  "address": {
    object (PostalAddress)
  },
  "phoneNumber": string
}
Alanlar
registeredDomain

string

Yalnızca çıkış. Hesabın kayıtlı alanı.

address

object (PostalAddress)

Yalnızca çıkış. Hesabın posta adresi.

phoneNumber

string

Yalnızca çıkış. Kuruluşun iletişim numarası.

PostalAddress

Bir posta adresini temsil eder, ör. veya ödeme adresleri için de geçerlidir. Posta adresi sayesinde, posta hizmetleri bir binaya ürün teslim edebilir. Kutu veya benzeri. Coğrafi konumları (yollar, kasabalar, dağlar) modellemesi amaçlanmamıştır.

Normal kullanımda adres, işlemin türüne bağlı olarak kullanıcı girişi aracılığıyla ya da mevcut verilerin içe aktarılmasıyla oluşturulur.

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

Bu şemanın nasıl kullanılacağıyla ilgili 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

integer

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

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

regionCode

string

Zorunlu. Adresin bulunduğu ülkenin/bölgenin CLDR bölge kodu. Bu durum hiçbir zaman tahmin edilmez ve değerin doğru olup olmadığını kontrol etmek 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 bakın. Örnek: "CH" kullanmaya başladım.

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 adreste kullanılan dillerden biriyle eşleşmesi beklenir ülke/bölge ya da harf çevirisi yapılmış eşdeğerleri. Bu, belirli ülkelerde biçimlendirmeyi etkileyebilir ancak verilerin doğruluğu açısından kritik öneme sahip değildir ve hiçbir zaman doğrulamayı veya biçimlendirmeyle ilgili olmayan diğer işlemleri etkilemez.

Bu değer bilinmiyorsa yanlış olabilecek bir varsayılan belirtmek yerine belirtilmemelidir.

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

postalCode

string

İsteğe bağlı. Adresin posta kodu. Bazı ülkeler posta kodlarını kullanmaz veya gerekli kılmaz, ancak kullanıldıkları yerde adresin diğer kısımlarında ek doğrulama (ör. ABD'de eyalet/posta kodu doğrulaması) tetiklenebilir.

sortingCode

string

İsteğe bağlı. Ülkeye özgü ek sıralama kodu. Bu ad çoğu bölgede kullanılmaz. Kullanıldığı yerde değer, "CEDEX" gibi bir dize ve isteğe bağlı olarak ardından bir sayı (ör. "CEDEX 7") veya "sektör kodunu" temsil eden yalnızca tek bir sayıdır (Jamaika), "teslimat alanı göstergesi" (Malavi) veya "postane göstergesi" (ör. Fildişi Sahili).

administrativeArea

string

İsteğe bağlı. Bir ülke 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. Özellikle, İspanya için bu, özerk topluluk değil, ildir (örneğin, "Katalonya" değil "Barselona"). Birçok ülke, posta adreslerinde idari bölge kullanmaz. Ör. İsviçre'de bu alan doldurulmadan bırakılmalıdır.

locality

string

İsteğe bağlı. Genellikle adresin şehir/ilçe bölümünü ifade eder. Örnekler: ABD şehri, BT komünü, Birleşik Krallık posta şehri. Dünyada yerlerin iyi tanımlanmadığı veya bu yapıya pek uygun olmadığı bölgelerde, locality alanını boş bırakın ve addressLines kullanın.

sublocality

string

İsteğe bağlı. Adresin alt konumu. Örneğin; mahalle, kaza, ilçe olabilir.

addressLines[]

string

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

addressLines'taki değerler tür bilgisi içermediğinden ve bazen tek bir alanda birden çok değer (ör. "Austin, TX") içerebildiğinden satır sırasının açık olması önemlidir. Adres satırlarının sırası "zarf sırası" olmalıdır girin. Bu özelliğin değişebileceği yerlerde (ör. Japonya), açık hale getirmek için address_language kullanılır (ör. büyükten küçüğe sıralama için "ja", küçükten büyüğe sıralama için "ja-Latn" ya da "en"). Bu şekilde, bir adresin en spesifik satırı dile göre seçilebilir.

Bir adresin izin verilen minimum yapısal gösterimi, kalan tüm bilgilerin addressLines içine yerleştirildiği bir regionCode'dan oluşur. Böyle bir adres, coğrafi kodlama olmadan yaklaşık olarak yaklaşık olarak biçimlendirilebilir ancak en azından kısmen çözümlenene kadar hiçbir adres bileşeni hakkında anlamsal çıkarımda bulunulamaz.

Yalnızca regionCode ve addressLines içeren bir adres oluşturduktan sonra coğrafi kodlama, tamamen yapılandırılmamış adresleri yönetmek için önerilen yöntemdir (adresin hangi bölümlerinin yerel bölgeler veya idari alanlar olması gerektiğini tahmin etmek yerine).

recipients[]

string

İsteğe bağlı. Adresteki alıcı. Bu alan, belirli durumlarda çok satırlı bilgiler içerebilir. Örneğin, ekleyebilirsiniz.

organization

string

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

Yöntemler

create

Belirtilen üst öğe altında belirtilen ad ve türle bir hesap oluşturur.

get

Belirtilen hesabı alır.

list

Kimliği doğrulanmış kullanıcının tüm hesaplarını listeler.

patch

Belirtilen işletme hesabını günceller.