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

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

emailAddress

string

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

نص الاستجابة

رسالة ردّ خاصة بـ customer.createCustomerClient.

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

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

string

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

نطاقات الأذونات

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

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

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