Method: customers.createCustomerClient

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

قائمة الأخطاء التي تظهر: AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError

طلب HTTP

POST https://googleads.googleapis.com/v14/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

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

string

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

نص الاستجابة

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

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

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

string

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

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

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

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

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