REST Resource: partners.customers

Kaynak: Şirket

El değmeden kayıt bayisi ve müşteri API'lerinde bir bayi, tedarikçi veya müşteri.

JSON gösterimi
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
Alanlar
name

string

Yalnızca çıkış. Şirketin API kaynağı adı. Kaynak adı, aşağıdaki biçimlerden biridir:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

Sunucu tarafından atanır.

companyId

string (int64 format)

Yalnızca çıkış. Şirketin kimliği. Sunucu tarafından atanır.

companyName

string

Zorunlu. Şirketin adı. Örneğin, XYZ Corp. El değmeden kayıt portalında şirket çalışanlarına gösterilir.

ownerEmails[]

string

Zorunlu. Yalnızca giriş. Müşterinin sahip rolündeki kullanıcılarının e-posta adresleri. En az bir owner_email gereklidir. Sahipler, yöneticilerle aynı erişime sahiptir ancak kuruluşunuzun portal kullanıcılarını da ekleyebilir, silebilir ve düzenleyebilir.

adminEmails[]

string

İsteğe bağlı. Müşterinin yönetici rolündeki kullanıcılarının e-posta adresleri. Her e-posta adresi bir Google Hesabı ile ilişkilendirilmelidir.

termsStatus

enum (TermsStatus)

Yalnızca çıkış. Şirketteki herhangi bir kullanıcının en son Hizmet Şartları'nı kabul edip etmediği. Şu sayfaya göz atın: TermsStatus.

skipWelcomeEmail

boolean

Yalnızca giriş. Politika, Doğru değerine ayarlanırsa karşılama e-postası müşteriye gönderilmez. Cihazlar ek DEVICE_PROTECTION hizmetiyle talep edilecekse karşılama e-postasını atlamanız önerilir. Çünkü müşteri, cihazın hak talebinde bulunduğu sırada ayrı e-postalar alır. Bu müşteri el değmeden kayıt özellikli müşteri değilse bu alan yoksayılır.

languageCode

string

Yalnızca giriş. Müşterinin, BCP47 dil kodu olarak gösterilen tercih edilen yerel ayarı. Bu alan giriş sırasında doğrulanır ve desteklenmeyen dil kodları içeren istekler reddedilir.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

Yalnızca çıkış. Bu müşteriyle ilişkilendirilmiş Google Workspace hesabı. Yalnızca müşteri Şirketleri için kullanılır.

TermsStatus

Şirketin el değmeden kayıt Hizmet Şartları'nı (ToS) kabul etmesi. Tek bir kullanıcı, web portalını kullanarak şirketinin Hizmet Şartları'nı kabul edebilir.

Hizmet şartları belirli sürümlerdir. Bu, Hizmet Şartları değiştiğinde, yeni Hizmet Şartları'nı en az bir kullanıcının kabul etmesi gerektiği anlamına gelir. İlk kullanıcı yeni Hizmet Şartları'nı kabul edene kadar şirketin şartları TERMS_STATUS_STALE olur.

Sıralamalar
TERMS_STATUS_NOT_ACCEPTED Şirketin kullanıcılarından hiçbiri Hizmet Şartları'nı kabul etmemiştir.
TERMS_STATUS_ACCEPTED Şirketin kullanıcılarından biri (veya daha fazlası) Hizmet Şartları'nı kabul etmiştir.
TERMS_STATUS_STALE Şirketin kullanıcılarından hiçbiri mevcut Hizmet Şartları'nı kabul etmemiş ancak en az bir kullanıcı daha önceki Hizmet Şartları'nı kabul etmiştir.

GoogleWorkspaceAccount

Google Workspace müşterisi

JSON gösterimi
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
Alanlar
customerId

string

Zorunlu. Müşteri kimliği.

preProvisioningTokens[]

string

Yalnızca çıkış. Daha önce cihazlar üzerinde hak talebinde bulunmak için kullanılan ön temel hazırlık jetonları.

Yöntemler

create

El değmeden kayıt için bir müşteri oluşturur.

list

partnerId bağımsız değişkeniyle tanımlanan bayiye kayıtlı müşterileri listeler.