Method: customers.customerUserAccesses.mutate

يشير إلى التحديثات، ويزيل إذن المستخدم من عميل معيّن. يتم عرض حالات العملية.

قائمة الأخطاء التي تم عرضها: AuthenticationError AuthorizationError CustomerUserAccessError FieldMaskError HeaderError InternalError MutateError QuotaError RequestError

طلب HTTP

POST https://googleads.googleapis.com/v17/customers/{customerId}/customerUserAccesses:mutate

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

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

المعلمات
customerId

string

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

نص الطلب

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

تمثيل JSON 
{
  "operation": {
    object (CustomerUserAccessOperation)
  }
}
الحقول
operation

object (CustomerUserAccessOperation)

مطلوبة. يشير هذا المصطلح إلى عملية تنفيذ الإجراء على حساب العميل.

نص الاستجابة

رسالة ردّ بشأن تغيير إذن وصول العميل.

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

تمثيل JSON 
{
  "result": {
    object (MutateCustomerUserAccessResult)
  }
}
الحقول
result

object (MutateCustomerUserAccessResult)

نتيجة الدالة mutate.

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

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

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

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

CustomerUserAccessOperation

عملية واحدة (تحديث أو إزالة) على وصول المستخدم إلى العميل.

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

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

string (FieldMask format)

قناع الحقل الذي يحدد حقول الموارد التي يتم تعديلها في التحديث.

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

object (CustomerUserAccess)

عملية التعديل: من المتوقع أن يكون لوصول مستخدم العميل اسم مورد صالح.
remove

string

عملية الإزالة: من المتوقع وجود اسم مورد للوصول الذي تمت إزالته بهذا التنسيق:

customers/{customerId}/customerUserAccesses/{CustomerUserAccess.user_id}

MutateCustomerUserAccessResult

نتيجة تغيير وصول العميل إلى المستخدم.

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

string

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