تأییدیه‌های چندجانبه در Google Ads API

پنجشنبه، ۲۵ ژوئن ۲۰۲۶

به‌عنوان بخشی از بهبود امنیت حساب‌های Google Ads، Google Ads API هنگام انجام کنش‌های حساس API، تأیید چندطرفه را الزامی خواهد کرد. این بخشی از تغییر گسترده‌تری در Google Ads است که برای انجام کنش‌های حساس در حساب Google Ads شما به تأیید چندطرفه نیاز دارد. این به‌روزرسانی‌های امنیتی مهم از ۲۷ ژوئیه ۲۰۲۶ عرضه خواهند شد و طی چند هفته آینده برای همه کاربران فعال خواهند شد.

چه مواردی تغییر می‌کند؟

وقتی این تغییر فعال شود، رفتار فراخوانی‌های میانای برنامه‌سازی کاربردی زیر تغییر خواهد کرد.

دعوت کردن کاربر

اگر از روش CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation برای دعوت از کاربر جدید برای مدیریت حساب Google Ads استفاده می‌کنید، Google Ads API اکنون ارزیابی می‌کند که آیا تأیید چندطرفه لازم است یا نه. در مواردی که سرورهای ما تشخیص دهند که بازبینی لازم است، سیستم گردش کار استاندارد را موقتاً متوقف می‌کند و بلافاصله CustomerUserAccessInvitation را تولید نمی‌کند یا ایمیل دعوت را ارسال نمی‌کند. به‌جای آن، منبع MultiPartyAuthReview با نام منبع ارائه‌شده در پاسخ شروع می‌شود. وقتی بازبینی معلقه ازسوی سرپرست حساب دوم تأیید شود، CustomerUserAccessInvitation ایجاد خواهد شد و کاربر دعوت‌شده ایمیل خود را دریافت خواهد کرد. تا زمانی که بازبینی معلق حل‌وفصل نشود، نمی‌توان دعوت جدیدی برای کاربر ایجاد کرد.

به‌روزرسانی یا خاتمه دادن دسترسی کاربر

اگر از روش CustomerUserAccessService.MutateCustomerUserAccess برای اصلاح اجازه‌های کاربر بااستفاده از عملیات به‌روزرسانی یا لغو دسترسی بااستفاده از عملیات برداشتن استفاده کنید، Google Ads API اکنون ارزیابی می‌کند که آیا تأیید چندجانبه لازم است یا نه. در مواردی که سرورهای ما تشخیص دهند که بازبینی لازم است، میانای برنامه‌سازی کاربردی یک منبع MultiPartyAuthReview در حالت معلق ایجاد می‌کند و نام منبع آن را برمی‌گرداند. اصلاحات درخواستی شما در وضعیت معلق باقی می‌ماند و تنها زمانی اعمال می‌شود که بازبینی چندجانبه با موفقیت توسط سرپرست حساب دوم تأیید شود. CustomerUserAccess دردست بررسی را نمی‌توان تغییر داد تا زمانی که بررسی معلقه حل‌وفصل شود.

چگونه درخواست تأیید چندطرفه را تأیید کنم؟

می‌توانید بااستفاده از روش‌های GoogleAdsService.Search یا GoogleAdsService.SearchStream و بااستفاده از پُرسمان GAQL زیر، MultiPartyAuthReview معلق را واکشی کنید. 

SELECT
    multi_party_auth_review.resource_name,
    multi_party_auth_review.multi_party_auth_review_id,
    multi_party_auth_review.creation_date_time,
    multi_party_auth_review.request_user_email,
    multi_party_auth_review.operation_type,
    multi_party_auth_review.justification,
    multi_party_auth_review.target_resource,
    multi_party_auth_review.customer_user_access_review.old_customer_user_access,
    multi_party_auth_review.customer_user_access_review.new_customer_user_access,
    multi_party_auth_review.customer_user_access_invitation_review.new_customer_user_access_invitation
FROM multi_party_auth_review
WHERE multi_party_auth_review.review_status = 'PENDING'

درخواست MultiPartyAuthReview معلقه را می‌توان بااستفاده از درخواست MultiPartyAuthReviewService.ResolveMultiPartyAuthReview API تأیید یا رد کرد. این بازبینی باید توسط سرپرست دومی انجام شود که درخواست اصلی را ایجاد نکرده است. این می‌تواند یک انسان یا یک حساب سرویس با امتیازهای سرپرست باشد. درخواست‌کننده اصلی می‌تواند بازبینی معلقه را لغو کند.

چه کاری باید انجام دهم؟

اگر برنامه‌تان از این روش‌ها استفاده می‌کند، حتماً آن را به‌روز کنید تا بتواند گردش‌های کار تأیید چندطرفه را قبل‌از ۲۷ ژوئیه ۲۰۲۶ مدیریت کند. پشتیبانی از تأییدیه‌های چندجانبه را به همه نسخه‌های اصلی میانای برنامه‌سازی کاربردی (v24.2،‏ v23.3،‏ v22.2، و v21.2) اضافه کرده‌ایم. اگر از کتابخانه کارخواه رسمی استفاده می‌کنید، حتماً جدیدترین نسخه آن را بارگیری کنید. برای کسب اطلاعات بیشتر درباره این تغییرات می‌توانید به راهنماهای زیر مراجعه کنید که جزئیات مربوط به موارد زیر را پوشش می‌دهند

اگر درباره این به‌روزرسانی سؤالی دارید یا می‌خواهید بیشتر گفتگو کنید، لطفاً در سرور Discord «انجمن تبلیغات و سنجش Google» با ما تماس بگیرید. برای مشکلات پشتیبانی فنی، به https://support.google.com/google-ads/contact/google_ads_api مراجعه کنید

پرتره نویسنده - ، تیم Google Ads API

برچسب‌ها: authorization، google-ads-api