إدارة أذونات وصول المستخدِمين

بصفتك مشرفًا، يمكنك إدارة مستويات وصول المستخدمين وأدوارهم في حساباتك على "إعلانات Google". يمكنك استرداد أدوار المستخدمين وتعديلها، وإرسال دعوات إلى المستخدمين، وإنهاء إمكانية وصول المستخدمين إلى حساب معيّن باستخدام Google Ads API. مزيد من المعلومات عن مستويات الوصول إلى الحساب

لإدارة وصول المستخدمين، يجب أن يكون لدى المستخدم أو حساب الخدمة الذي يرسل الطلب إذن الوصول ADMIN إلى الحساب المستهدف.

دعوة مستخدمين

لدعوة مستخدم جديد للوصول إلى حساب، استخدِم الرمز CustomerUserAccessInvitationService لإنشاء دعوة وإرسالها (راجِع مقالة إدارة دعوات الوصول إلى حسابات المستخدمين). بعد أن يقبل المستخدم الدعوة، سيظهر كمستخدم مؤكَّد ضمن CustomerUserAccess.

استرداد أدوار المستخدمين

يمكنك الحصول على قائمة المستخدمين الذين لديهم إذن الوصول إلى حساب معيّن من خلال إنشاء عبارة لغة طلب البحث في "إعلانات Google" لطلب البحث عن جميع عناصر CustomerUserAccess المرتبطة برقم تعريف عميل معيّن. في ما يلي مثال على طلب بحث نموذجي:

SELECT
  customer_user_access.user_id,
  customer_user_access.email_address,
  customer_user_access.access_role,
  customer_user_access.access_creation_date_time,
  customer_user_access.inviter_user_email_address
FROM customer_user_access

تعديل أدوار المستخدمين

لتعديل دور مستخدم حالي، يمكنك استدعاء CustomerUserAccessService.MutateCustomerUserAccess باستخدام العملية UPDATE. عند تعديل دور مستخدم، يجب تقديم ما يلي:

  • اسم المورد لكيان CustomerUserAccess المطلوب تعديله، بالتنسيق customers/{customer_id}/customerUserAccesses/{user_id}.
  • دور المستخدم الجديد في access_role
  • ‫update_mask (FieldMask) يحدّد access_role.

إزالة المستخدمين

لإنهاء وصول المستخدم إلى الحساب، يمكنك استدعاء CustomerUserAccessService.MutateCustomerUserAccess باستخدام عملية REMOVE تحدّد اسم المورد (customers/{customer_id}/customerUserAccesses/{user_id}).

موافقة جهات متعددة على تغييرات أذونات الوصول

إذا تم إرسال طلب موافقة جهات متعددة عند استدعاء MutateCustomerUserAccess: