يقوم بإنشاء عميل جديد تحت المدير. يتم إرجاع العميل الجديد.
قائمة الأخطاء الملموسة: AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError
طلب HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:createCustomerClient
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف المدير الذي يتم إنشاء العميل للعميل بموجبه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "customerClient": { object ( |
الحقول | |
---|---|
customerClient |
مطلوبة. العميل الجديد المطلوب إنشاؤه. سيتم تجاهل اسم المورد لهذا العميل. |
accessRole |
الدور المقترَح للمستخدم في حساب العميل الذي تم إنشاؤه. لا يمكن الوصول إليها إلا للعملاء المدرَجين في القائمة المسموح بها. |
validateOnly |
إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب ولكن لا يتم تنفيذه. يتم عرض الأخطاء فقط وليس النتائج. |
emailAddress |
عنوان البريد الإلكتروني للمستخدم الذي يجب دعوته إلى حساب العميل الذي تم إنشاؤه لا يمكن الوصول إليها إلا للعملاء المدرَجين في القائمة المسموح بها. |
نص الاستجابة
رسالة رد لعملية تغيير customer.createCustomerClient.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "resourceName": string, "invitationLink": string } |
الحقول | |
---|---|
resourceName |
اسم المورد للعميل الذي تم إنشاؤه حديثًا. وتكون أسماء موارد العملاء على النحو التالي: |
invitationLink |
رابط لدعوة المستخدم للوصول إلى العميل الذي تم إنشاؤه. لا تتوفّر هذه الميزة إلا للعملاء ضمن القائمة المسموح بها. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.