بصفتك مشرفًا، يمكنك إدارة مستويات وصول المستخدمين وأدوارهم في حساباتك على "إعلانات Google". يمكن لواجهة برمجة التطبيقات Google Ads API استرداد أدوار المستخدمين وتعديلها، بالإضافة إلى إنهاء إذن وصول المستخدم إلى حساب. مزيد من المعلومات عن مستويات الوصول إلى الحساب
استرداد أدوار المستخدمين
يمكنك الحصول على قائمة بالمستخدمين الذين يمكنهم الوصول إلى حساب من خلال إنشاء عبارة لغة طلبات البحث في "إعلانات 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 الذي سيتم تعديله، بالإضافة إلى دور المستخدم الجديد.
في حال بدء طلب موافقة جهات متعددة:
- ستملأ
MutateCustomerUserAccessResponseالحقلmulti_party_auth_reviewالذي يحتوي على اسم المورد للمراجعة المعلّقة التي تتطلّب الموافقة. - لن تتم تعبئة الحقل "
resource_name". - يمكن لمشرف ثانٍ الموافقة على طلب المراجعة المعلّق أو رفضه باستخدام طريقة
MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. لمزيد من المعلومات، يُرجى الرجوع إلى دليل موافقة جهات متعددة.
إزالة المستخدمين
لإنهاء إذن وصول مستخدم إلى الحساب، اتّصِل بالرقم CustomerUserAccessService.MutateCustomerUserAccess مع عملية REMOVE.
في حال بدء طلب موافقة جهات متعددة:
- ستملأ
MutateCustomerUserAccessResponseالحقلmulti_party_auth_reviewالذي يحتوي على اسم المورد للمراجعة المعلّقة التي تتطلّب الموافقة. - لن تتم تعبئة الحقل "
resource_name". - يمكن لمشرف ثانٍ الموافقة على طلب المراجعة المعلّق أو رفضه باستخدام طريقة
MultiPartyAuthReviewService.ResolveMultiPartyAuthReview. لمزيد من المعلومات، يُرجى الرجوع إلى دليل موافقة جهات متعددة.