REST Resource: partners.customers

منبع: شرکت

یک فروشنده، فروشنده یا مشتری در APIهای فروشنده و مشتری بدون لمس.

نمایندگی JSON
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
زمینه های
name

string

فقط خروجی نام منبع API شرکت. نام منبع یکی از قالب های زیر است:

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

توسط سرور اختصاص داده شده است.

companyId

string ( int64 format)

فقط خروجی شناسه شرکت. توسط سرور اختصاص داده شده است.

companyName

string

ضروری. نام شرکت. به عنوان مثال XYZ Corp. در پورتال ثبت نام بدون لمس برای کارکنان شرکت نمایش داده می شود.

ownerEmails[]

string

ضروری. فقط ورودی آدرس ایمیل کاربران مشتری در نقش مالک. حداقل یک owner_email مورد نیاز است. مالکان دسترسی مشابهی با مدیران دارند، اما همچنین می توانند کاربران پورتال سازمان شما را اضافه، حذف و ویرایش کنند.

adminEmails[]

string

اختیاری. آدرس ایمیل کاربران مشتری در نقش ادمین. هر آدرس ایمیل باید با یک حساب Google مرتبط باشد.

termsStatus

enum ( TermsStatus )

فقط خروجی اینکه آیا هر کاربری از این شرکت آخرین شرایط خدمات (ToS) را پذیرفته است یا خیر. TermsStatus ببینید.

skipWelcomeEmail

boolean

فقط ورودی اگر روی true تنظیم شود، ایمیل خوش آمدگویی برای مشتری ارسال نخواهد شد. توصیه می‌شود در صورتی که دستگاه‌ها با سرویس DEVICE_PROTECTION اضافی درخواست می‌شوند، ایمیل خوش‌آمدگویی را نادیده بگیرید، زیرا مشتری ایمیل‌های جداگانه‌ای را در زمان ادعای دستگاه دریافت می‌کند. اگر مشتری Zero-touch نباشد، این قسمت نادیده گرفته می شود.

languageCode

string

فقط ورودی محلی ترجیحی مشتری به عنوان کد زبان BCP47 نشان داده شده است. این فیلد در ورودی تایید می‌شود و درخواست‌های حاوی کدهای زبان پشتیبانی‌نشده رد می‌شوند. کدهای زبان پشتیبانی شده: عربی (ar) چینی (هنگ کنگ) (zh-HK) چینی (ساده شده) (zh-CN) چینی (سنتی) (zh-TW) چک (cs) دانمارکی (da) هلندی (nl) انگلیسی ( بریتانیا) (en-GB) انگلیسی (ایالات متحده) (en-US) فیلیپینی (fil) فنلاندی (fi) فرانسوی (fr) آلمانی (de) عبری (iw) هندی (hi) مجارستانی (hu) اندونزیایی (id) ایتالیایی (id) آن) ژاپنی (ja) کره ای (ko) نروژی (بوکمال) (نه) لهستانی (pl) پرتغالی (برزیل) (pt-BR) پرتغالی (پرتغال) (pt-PT) روسی (ru) اسپانیایی (es) اسپانیایی (لاتین) آمریکا) (es-419) سوئدی (sv) تایلندی (th) ترکی (tr) اوکراینی (بریتانیا) ویتنامی (vi)

googleWorkspaceAccount

object ( GoogleWorkspaceAccount )

فقط خروجی حساب Google Workspace مرتبط با این مشتری. فقط برای شرکت های مشتری استفاده می شود.

وضعیت شرایط

پذیرش یک شرکت از شرایط خدمات ثبت نام بدون لمس (ToS). یک کاربر می تواند با استفاده از پورتال وب، ToS را برای شرکت خود بپذیرد.

ToS نسخه شده است. این بدان معناست که هنگام تغییر ToS، حداقل یک کاربر باید ToS جدید را بپذیرد. تا زمانی که اولین کاربر شرایط جدید را نپذیرد، وضعیت شرایط شرکت TERMS_STATUS_STALE است.

Enums
TERMS_STATUS_NOT_ACCEPTED هیچ یک از کاربران این شرکت ToS را نپذیرفته اند.
TERMS_STATUS_ACCEPTED یک (یا چند نفر) از کاربران این شرکت ToS را پذیرفته اند.
TERMS_STATUS_STALE هیچ یک از کاربران این شرکت ToS فعلی را نپذیرفته اند، اما حداقل یک کاربر ToS قبلی را پذیرفته است.

حساب GoogleWorkspace

یک مشتری Google Workspace.

نمایندگی JSON
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
زمینه های
customerId

string

ضروری. شناسه مشتری

preProvisioningTokens[]

string

فقط خروجی توکن‌های پیش‌پروری که قبلاً برای ادعای دستگاه‌ها استفاده می‌شدند.

مواد و روش ها

create

 یک مشتری برای ثبت نام بدون لمس ایجاد می کند.

list

 مشتریانی را که در فروشنده شناسایی شده توسط آرگومان partnerId ثبت نام کرده اند فهرست می کند.