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 عند إنشاء عميل جديد. لا تُدرِج البادئة www في النطاق عند إضافة عميل.
postalAddress

object (Address)

معلومات عنوان العميل يبلغ الحد الأقصى لعدد الأحرف في كل حقل 255 حرفًا.
phoneNumber

string

رقم هاتف العميل المخصّص للتواصل يجب أن يبدأ بعلامة "+" متبوعة برمز البلد. يمكن أن تكون بقية الرقم أرقامًا متسلسلة أو تتوافق مع اصطلاحات التنسيق المحلي للهاتف، ولكن يجب أن يكون رقم هاتف حقيقيًا وليس "123" مثلاً. يتم تجاهل هذا الحقل بدون إشعار في حال عدم صلاحيته.
alternateEmail

string

مثل "عنوان البريد الإلكتروني للعميل" في أدوات المورّدين، يكون عنوان البريد الإلكتروني هذا هو جهة الاتصال الثانوية المستخدَمة في حال حدوث أي مشكلة في خدمة العميل، مثل انقطاع الخدمة أو مشكلة أمنية. تكون هذه السمة مطلوبة عند إنشاء عميل "نطاق" جديد، ويجب ألا يستخدم النطاق نفسه المستخدَم في customerDomain. ليس من الضروري استخدام الحقل alternateEmail لإنشاء عميل "فريق".
resourceUiUrl

string

عنوان URL المؤدي إلى لوحة بيانات "وحدة تحكّم المشرف" للعميل يتم إنشاء عنوان URL للقراءة فقط بواسطة خدمة واجهة برمجة التطبيقات. يتم استخدام هذا الإجراء إذا كان تطبيق العميل يتطلّب من العميل إكمال مهمة في "وحدة تحكّم المشرف".
customerDomainVerified

boolean

ما إذا تم إثبات ملكية النطاق الأساسي للعميل
kind

string

تُحدِّد هذه السمة المورد كعميل. القيمة: reseller#customer
customerType

enum (CustomerType)

لتحديد نوع العميل. تشمل القيم المقبولة ما يلي:

  • ‫domain: يشير إلى عميل تم إثبات ملكية نطاقه (الإعداد التلقائي).
  • team: يشير إلى عميل تم إثبات ملكيته باستخدام عنوان البريد الإلكتروني.

لمزيد من المعلومات، يُرجى الاطّلاع على الفِرق المُدارة.
primaryAdmin

object (PrimaryAdmin)

تفاصيل المشرف الأول للعميل، وهي متوفّرة في حال كان العميل من النوع "فريق".

العنوان

نموذج 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

اسم جهة اتصال العميل. هذا الحقل مطلوب.

CustomerType

نوع العميل

عمليات التعداد
customerTypeUnspecified نوع العميل غير معروف
domain العملاء الذين يملكون نطاقًا أو لديهم نطاق
team العملاء الذين لا يملكون نطاقًا أو الذين تم إثبات ملكيتهم من خلال عنوان البريد الإلكتروني

PrimaryAdmin

نموذج JSON للمشرف الأساسي في حال عملاء "الفريق"

تمثيل JSON 
{
  "primaryEmail": string
}
الحقول
primaryEmail

string

عنوان البريد الإلكتروني لنشاط العميل التجاري للمشرف الأساسي للعميل.

يتم إرسال رابط إثبات ملكية البريد الإلكتروني إلى عنوان البريد الإلكتروني هذا في وقت إنشاء العميل. يمكن للمشرفين الأساسيين الوصول إلى "وحدة تحكّم المشرف" الخاصة بالعميل، بما في ذلك إمكانية دعوة المستخدمين وإجلائهم وإدارة الاحتياجات الإدارية للعميل.

الطُرق

get

 الحصول على حساب عميل

insert

 طلب حساب عميل جديد

patch

 تعديل إعدادات حساب عميل

update

 تعديل إعدادات حساب عميل