REST Resource: customers

منبع: مشتری

هنگامی که حساب مشتری Google در یک فروشنده ثبت می شود، اشتراک مشتری برای خدمات Google توسط این فروشنده مدیریت می شود. یک مشتری با یک نام دامنه اصلی و یک آدرس فیزیکی توصیف می شود.

نمایندگی JSON
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
زمینه های
customerId

string

این ویژگی همیشه در یک پاسخ به عنوان شناسه منحصر به فرد تولید شده توسط Google برگردانده می شود. در یک درخواست، این ویژگی می تواند دامنه اصلی یا شناسه منحصر به فرد ایجاد شده توسط Google باشد.

customerDomain

string

رشته نام دامنه اصلی مشتری. هنگام ایجاد یک customerDomain جدید، domain domain مورد نیاز است. هنگام اضافه کردن مشتری، پیشوند www را در دامنه وارد نکنید.

postalAddress

object ( Address )

اطلاعات آدرس یک مشتری هر فیلد دارای محدودیت 255 نویسه است.

phoneNumber

string

شماره تماس با مشتری باید با "+" و سپس کد کشور شروع شود. بقیه شماره می تواند اعداد پیوسته باشد یا به قراردادهای قالب محلی تلفن احترام بگذارد، اما باید یک شماره تلفن واقعی باشد و مثلاً «123» نباشد. این فیلد در صورت نامعتبر بودن بی‌صدا نادیده گرفته می‌شود.

alternateEmail

string

مانند «ایمیل مشتری» در ابزارهای فروشنده، این ایمیل تماس ثانویه ای است که اگر برای خدمات مشتری اتفاقی بیفتد مانند قطع سرویس یا مشکل امنیتی استفاده می شود. این ویژگی هنگام ایجاد یک مشتری "دامنه" جدید مورد نیاز است و نباید از دامنه مشابه با customerDomain استفاده کند. فیلد alternateEmail برای ایجاد یک مشتری "تیم" ضروری نیست.

resourceUiUrl

string

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

customerDomainVerified

boolean

آیا دامنه اصلی مشتری تأیید شده است یا خیر.

kind

string

منبع را به عنوان مشتری شناسایی می کند. ارزش: reseller#customer

customerType

enum ( CustomerType )

نوع مشتری را مشخص می کند. مقادیر قابل قبول عبارتند از:

  • domain : دلالت بر یک مشتری تایید شده توسط دامنه (پیش فرض).
  • team : به معنای یک مشتری تایید شده از طریق ایمیل است.

برای اطلاعات بیشتر، تیم های مدیریت شده را ببینید.

primaryAdmin

object ( PrimaryAdmin )

اولین جزئیات مدیریت مشتری، در مورد مشتری TEAM وجود دارد.

نشانی

قالب JSON برای آدرس مشتری.

نمایندگی JSON
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
زمینه های
countryCode

string

برای اطلاعات countryCode کشور، به عناصر کد کشور ISO 3166 مراجعه کنید. تأیید کنید که این کشور برای فروش مجدد محصولات Google تأیید شده است. این ویژگی هنگام ایجاد یک مشتری جدید مورد نیاز است.

kind

string

منبع را به عنوان آدرس مشتری شناسایی می کند. ارزش: customers#address

region

string

نمونه ای از مقدار region CA برای ایالت کالیفرنیا است.

addressLine2

string

خط 2 آدرس

locality

string

نمونه ای از ارزش locality شهر San Francisco است.

addressLine3

string

خط 3 آدرس.

postalCode

string

یک مثال کد پستی یک کد پستی پستی مانند postalCode 94043 . این ویژگی هنگام ایجاد یک مشتری جدید مورد نیاز است.

addressLine1

string

آدرس فیزیکی یک مشتری یک آدرس می تواند از یک تا سه خط تشکیل شود. addressline2 و addressLine3 اختیاری هستند.

organizationName

string

نام شرکت یا بخش شرکت. این مورد نیاز است.

contactName

string

نام مخاطب مشتری این مورد نیاز است.

نوع مشتری

نوع مشتری

Enums
customerTypeUnspecified نوع مشتری مشخص نیست
domain مشتریان دامنه دار یا صاحب دامنه
team مشتریان بدون دامنه یا تایید شده از طریق ایمیل

Primary Admin

قالب JSON برای سرپرست اصلی در مورد مشتریان TEAM

نمایندگی JSON
{
  "primaryEmail": string
}
زمینه های
primaryEmail

string

ایمیل تجاری مدیر اصلی مشتری.

لینک تایید ایمیل در زمان ایجاد مشتری به این آدرس ایمیل ارسال می شود. مدیران اصلی به کنسول مدیریت مشتری دسترسی دارند، از جمله توانایی دعوت و اخراج کاربران و مدیریت نیازهای اداری مشتری.

مواد و روش ها

get

 حساب مشتری می گیرد.

insert

 یک حساب کاربری جدید سفارش می دهد.

patch

 تنظیمات حساب مشتری را به روز می کند.

update

 تنظیمات حساب مشتری را به روز می کند.