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

رقم هاتف جهة اتصال العميل. يجب أن يبدأ الرمز بـ "+;quot; متبوعًا برمز البلد. ويمكن أن يكون باقي الرقم أرقامًا متجاورة أو أن يلتزم بـ اصطلاحات التنسيق المحلي للهاتف، ولكن يجب أن يكون رقم هاتف حقيقيًا وليس مثلاً، "123&quot. يتم تجاهل هذا الحقل في حال عدم وجوده صالحًا.

alternateEmail

string

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

resourceUiUrl

string

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

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

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

نوع العميل

نوع العميل

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

المشرف الأساسي

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

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

string

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

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

الطُرق

get

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

insert

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

patch

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

update

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