Method: customers.createCustomerClient

يقوم بإنشاء عميل جديد تحت المدير. يتم إرجاع العميل الجديد.

قائمة الأخطاء الملموسة: AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError

طلب HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:createCustomerClient

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
customerId

string

مطلوبة. رقم تعريف المدير الذي يتم إنشاء العميل للعميل بموجبه.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "customerClient": {
    object (Customer)
  },
  "accessRole": enum (AccessRole),
  "validateOnly": boolean,
  "emailAddress": string
}
الحقول
customerClient

object (Customer)

مطلوبة. العميل الجديد المطلوب إنشاؤه. سيتم تجاهل اسم المورد لهذا العميل.

accessRole

enum (AccessRole)

الدور المقترَح للمستخدم في حساب العميل الذي تم إنشاؤه. لا يمكن الوصول إليها إلا للعملاء المدرَجين في القائمة المسموح بها.

validateOnly

boolean

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

emailAddress

string

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

نص الاستجابة

رسالة رد لعملية تغيير customer.createCustomerClient.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "resourceName": string,
  "invitationLink": string
}
الحقول
resourceName

string

اسم المورد للعميل الذي تم إنشاؤه حديثًا. وتكون أسماء موارد العملاء على النحو التالي: customers/{customerId}.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/adwords

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.