بصفتك مشرفًا، يمكنك إدارة مستويات وصول المستخدمين وأدوارهم في حساباتك على "إعلانات 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:
- سيؤدي عنصر
MutateCustomerUserAccessResult(المضمّن في حقلresultفيMutateCustomerUserAccessResponse) إلى ملء حقلmulti_party_auth_reviewباسم المورد للمراجعة المعلّقة التي تتطلّب الموافقة. - لن تتم تعبئة الحقل "
resource_name" في "MutateCustomerUserAccessResult". - يمكن لمشرف ثانٍ الموافقة على طلب المراجعة المعلَّق أو رفضه باستخدام طريقة
MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. لمزيد من المعلومات، يُرجى الرجوع إلى دليل موافقة جهات متعددة.