چهارشنبه، ۴ نوامبر ۲۰۲۶
اوایل امسال، Google Ads API هنگام انجام کنش‌های حساس API، تأیید چندطرفه (MPA) را الزامی کرد. از هفته ۷ دسامبر ۲۰۲۶، تغییرات بیشتری را برای بهبود تجربه توسعه‌دهنده در تأییدیه‌های چندطرفه معرفی می‌کنیم.
چه چیزی تغییر می‌کند؟
ایجاد دعوت دسترسی معوق: اگر تأیید چندجانبه لازم باشد، روش CustomerUserAccessInvitationService.MutateCustomerUserAccessInvitation ایجاد منبع دعوت دسترسی را تا زمانی که درخواست تأیید چندجانبه تأیید شود به تعویق می‌اندازد. در چنین مواردی، فیلد resource_name درج نمی‌شود. وقتی درخواست «مجوزدهی چندطرفی» معلقه تأیید شد، منبع دعوت دسترسی ازطریق نتایج بازبینی دردسترس قرار می‌گیرد. درحال‌حاضر، این روش دعوت را ایجاد می‌کند و resource_name دعوت را برمی‌گرداند، اما تا زمانی که درخواست «مجوزدهی چندطرفی» مربوطه تأیید نشود، کنش‌های اضافی مانند ارسال ایمیل دعوت را انجام نمی‌دهد.
کد خطای جدید برای درخواست‌های قدیمی: وقتی درخواست مجوزدهی چندطرفی معلق دیگر معتبر نباشد، چون منبع هدف پس‌از ایجاد بازبینی اصلاح یا حذف شده است، کد خطای جدید MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST را در فیلد خطای جزئی برمی‌گردانیم. این کد خطا در نسخه آتی v26.2 معرفی خواهد شد. نسخه‌های قدیمی‌تر میانای برنامه‌سازی کاربردی (v23 تا v25) خطای MultiPartyAuthReviewError.UNKNOWN را برمی‌گردانند و فیلد unpublished_error_code در GoogleAdsError.details روی MultiPartyAuthReviewError.STALE_MULTI_PARTY_AUTH_REQUEST تنظیم خواهد شد.
افزایش محدودیت‌ها برای بازبینی‌های MPA: می‌توانید تا ۱۰۰ بازبینی MPA معلقه را در یک فراخوانی به روش MultiPartyAuthReviewService.ResolveMultiPartyAuthReview حل‌وفصل کنید. درحال‌حاضر، این روش به یک مرور در هر فراخوانی میانای برنامه‌سازی کاربردی محدود است.
اقدام لازم است
اگر از تأییدیه‌های چندطرفه استفاده می‌کنید، کدتان را قبل‌از ۷ دسامبر ۲۰۲۶ بازبینی و به‌روز کنید تا رفتار جدید میانای برنامه‌سازی کاربردی را منعکس کند. اگر از نسخه ۲۶ Google Ads API استفاده می‌کنید، پس‌از انتشار نسخه ۲۶.۲، جدیدترین کتابخانه‌های کارخواه را بارگیری کنید تا از کد خطای جدید STALE_MULTI_PARTY_AUTH_REQUEST پشتیبانی دریافت کنید. برای کسب اطلاعات بیشتر درباره تأیید چندطرفه، به راهنماهای فنی ما مراجعه کنید. برای مشکلات پشتیبانی فنی، با پشتیبانی Google Ads API تماس بگیرید. اگر سؤالی دارید یا می‌خواهید درباره این پست بحث کنید، در سرور Discord انجمن تبلیغات و سنجش Google با ما تماس بگیرید.
- Anash P. Oommen، تیم Google Ads API
برچسب‌ها: authorization، google-ads-api، release