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ı. Hedef, accounts/{account_id} biçiminde olmalıdır.
type

enum (AccountType)

Zorunlu. Hesap türünü içerir. Bu API kullanılarak PERSONAL ve Kuruluş türündeki hesaplar 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 denetleme gerektirmeden Google+ sayfaları oluşturulur.
vettedState

enum (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

string

Yalnızca çıkış. Temel hazırlığı yapıldıysa 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 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 (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. 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

integer

PostalAddress öğesinin şema düzeltmesi. Bu değer, en son düzeltme olan 0 olarak 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 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

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 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

string

İ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

string

İ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

string

İ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

string

İ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

string

İsteğe bağlı. Adresin semti. Örneğin bu mahalleler, ilçeler, semtler olabilir.
addressLines[]

string

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[]

string

İ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

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.