بصفتك مشرفًا، يمكنك إدارة مستويات وصول المستخدمين وأدوارهم في حساباتك على "إعلانات 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. لمزيد من المعلومات، يُرجى الرجوع إلى دليل موافقة جهات متعددة.