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