بهعنوان سرپرست، میتوانید سطوح دسترسی و نقشهای کاربر را برای حسابهای Google Ads خود مدیریت کنید. بااستفاده از Google Ads API میتوانید نقشهای کاربر را بازیابی و بهروز کنید، برای کاربر دعوت ارسال کنید، و دسترسی کاربر به حساب را لغو کنید. درباره سطوح دسترسی به حساب بیشتر بدانید.
برای مدیریت دسترسی کاربر، کاربر تماسگیرنده یا حساب سرویس باید به حساب هدف دسترسی ADMIN داشته باشد.
دعوت از کاربران
برای دعوت کردن کاربر جدید برای دسترسی به حساب، از
CustomerUserAccessInvitationService برای ایجاد و ارسال دعوت استفاده کنید (به
مدیریت دعوتهای دسترسی کاربر مراجعه کنید). وقتی کاربر دعوت را بپذیرد، بهعنوان کاربر تأییدشده در CustomerUserAccess نشان داده میشود.
بازیابی نقشهای کاربر
میتوانید با ساختن عبارت زبان پُرسمان Google Ads برای پُرسمان کردن همه نهادهای 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تأیید یا رد کند. برای کسب اطلاعات بیشتر، به راهنمای تأیید چندطرفه مراجعه کنید.