Method: customers.accountLinks.mutate

لإنشاء رابط حساب أو إزالته اعتبارًا من الإصدار 5، لا يمكن إنشاء الرابط من خلال AccountLinkService.MutateAccountLink. استخدِم AccountLinkService.CreateAccountLink بدلاً من ذلك.

قائمة بالأخطاء التي تمّ طرحها: AccountLinkError AuthenticationError AuthorizationError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v19/customers/{customerId}/accountLinks:mutate

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

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

المعلمات
customerId

string

مطلوب. رقم تعريف العميل الذي يتم تعديله.

نص الطلب

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

تمثيل JSON 
{
  "operation": {
    object (AccountLinkOperation)
  },
  "partialFailure": boolean,
  "validateOnly": boolean
}
الحقول
operation

object (AccountLinkOperation)

مطلوب. العملية التي سيتم تنفيذها على الرابط.
partialFailure

boolean

إذا كانت القيمة صحيحة، سيتم تنفيذ العمليات الناجحة وستؤدي العمليات غير الصالحة إلى ظهور أخطاء. إذا كانت القيمة false، سيتم تنفيذ جميع العمليات في معاملة واحدة إذا كانت جميعها صالحة فقط. القيمة التلقائية هي false.
validateOnly

boolean

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

نص الاستجابة

رسالة الردّ على تغيير رابط الحساب

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

تمثيل JSON 
{
  "result": {
    object (MutateAccountLinkResult)
  },
  "partialFailureError": {
    object (Status)
  }
}
الحقول
result

object (MutateAccountLinkResult)

نتيجة التحويل.
partialFailureError

object (Status)

الأخطاء المتعلّقة بتعذُّر تنفيذ العمليات في وضع الفشل الجزئي لا يتم عرض هذا الحقل إلا عندما يكون partialFailure = true وتحدث جميع الأخطاء داخل العمليات. في حال حدوث أي أخطاء خارج نطاق العمليات (مثل أخطاء المصادقة)، سنعرض خطأ على مستوى طلب إجراء الاتصال.

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

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

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

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

AccountLinkOperation

تعديل واحد على رابط حساب

تمثيل JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "update": {
    object (AccountLink)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
الحقول
updateMask

string (FieldMask format)

FieldMask التي تحدّد حقول الموارد التي يتم تعديلها في عملية تعديل

هذه قائمة مفصولة بفواصل تتضمّن أسماء حقول مؤهَّلة بالكامل. مثال: "user.displayName,photo"
حقل الربط operation العملية المطلوب تنفيذها. يمكن أن يكون operation واحدًا فقط مما يلي:
update

object (AccountLink)

عملية التعديل: من المتوقّع أن يحتوي رابط الحساب على اسم مورد صالح.
remove

string

عملية الإزالة: من المتوقّع أن يتضمّن الطلب اسم مورد لرابط الحساب المطلوب إزالته، وذلك على النحو التالي:

customers/{customerId}/accountLinks/{accountLinkId}

MutateAccountLinkResult

تغيُّر نتيجة ربط الحساب

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

string

يتم إرجاعه للعمليات الناجحة.