پنجشنبه، ۱۰ سپتامبر ۲۰۲۶
برای بهبود تجربه آماده‌سازی و استفاده توسعه‌دهنده، صفحه اصلی جدیدی برای Google Ads API در کنسول Google Cloud ساختیم. درخواست‌های «دسترسی پایه» اکنون برای توسعه‌دهندگانی که درستی‌سنجی نمانام را تکمیل کرده‌اند خودکارسازی شده است. این پست وبلاگ چندین تغییر مرتبط را پوشش می‌دهد که از امروز عرضه خواهند شد. توسعه‌دهندگان باید بخش اقدام لازم این پست را مرور کنند تا از انتقال روان مطمئن شوند.
تغییرات در مدیریت دسترسی میانای برنامه‌سازی کاربردی
درحال به‌روزرسانی نحوه ثبت‌نام و مدیریت دسترسی به Google Ads API هستیم.
تجربه آماده‌سازی جدید برای Google Ads API: اکنون می‌توانید مستقیماً در «کنسول Google Cloud» برای دسترسی به Google Ads API ثبت‌نام کنید بدون اینکه به حساب مدیر Google Ads نیاز داشته باشید. ما درحال برچیدن همه عملکردهای ثبت‌نام جدید و مدیریت دسترسی به میانای برنامه‌سازی کاربردی در صفحه مرکز میانای برنامه‌سازی کاربردی در حساب‌های مدیر و انتقال به صفحه نمای کلی Google Ads API در «کنسول Google Cloud» هستیم. همچنان می‌توانید به صفحه مرکز API دسترسی داشته باشید تا به جزئیات توسعه‌دهنده قدیمی‌تان مراجعه کنید. این صفحه در آینده کاملاً برچیده خواهد شد.
سطوح دسترسی به میانای برنامه‌سازی کاربردی با پروژه‌های Google Cloud مرتبط است: در حال منسوخ کردن کدهای توسعه‌دهنده هستیم. سطح دسترسی کد توسعه‌دهنده فعلی و فعال شما به‌طور خودکار براساس فعالیت اخیر میانای برنامه‌سازی کاربردی به پروژه‌های Google Cloud شما منتقل می‌شود. می‌توانید همچنان کدهای توسعه‌دهنده را در سرصفحه‌های فراخوانی میانای برنامه‌سازی کاربردی ارسال کنید، اما این کار اختیاری است و سرورهای میانای برنامه‌سازی کاربردی آن را نادیده می‌گیرند. کد فعلی شما بدون هیچ تغییری به کار خود ادامه خواهد داد. سطوح «دسترسی به میانای برنامه‌سازی کاربردی» شما اکنون توسط پروژه Google Cloud که برای تولید اطلاعات کاربری OAuth استفاده کرده‌اید تعیین می‌شود. برای کسب اطلاعات بیشتر درباره این تغییر و عیب‌یابی مشکلاتی که ممکن است با آن‌ها مواجه شوید، به صفحه پرسشگان ما مراجعه کنید.
کد خطای جدید: نسخه v25 از Google Ads API اگر بخواهید از پروژه Google Cloud با سطح دسترسی حساب آزمایشی برای برقراری تماس با حساب تولید استفاده کنید، خطای CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION را نشان خواهد داد. نسخه‌های قدیمی‌تر میانای برنامه‌سازی کاربردی به‌جای آن خطای ACTION_NOT_PERMITTED را نشان خواهند داد. اگر با این خطا مواجه شدید، به صفحه نمای کلی Google Ads API برای پروژه Google Cloud خود بروید و برای Explorer Access درخواست دهید.
تغییرات در فرایند بازبینی میانای برنامه‌سازی کاربردی
درستی‌سنجی نمانام برای دسترسی «پایه» و «استاندارد» الزامی است: برای برنامه‌های جدید «دسترسی پایه» و «استاندارد»، باید درستی‌سنجی نمانام را برای پروژه Google Cloud خود تکمیل کنید . دارندگان دسترسی فعلی ملزم به تکمیل درستی‌سنجی نمانام نیستند، اما این کار توصیه می‌شود.
تأییدیه‌های خودکارشده دسترسی پایه: درخواست‌های دسترسی پایه اکنون خودکار شده‌اند و ظرف چند دقیقه پس‌از درستی‌سنجی و ارسال نمانام بازبینی خواهند شد.
رد کردن یک‌باره درخواست‌های دسترسی «پایه» معلقه: به‌دلیل این به‌روزرسانی‌های فرایند، همه درخواست‌های دسترسی معلقه به میانای برنامه‌سازی کاربردی «پایه» به‌عنوان بخشی از این انتقال بسته خواهند شد. متقاضیان تحت‌تأثیر ایمیلی حاوی جزئیات دریافت خواهند کرد و باید ازطریق صفحه نمای کلی Google Ads API دوباره برای دسترسی به میانای برنامه‌سازی کاربردی درخواست دهند.
اقدام لازم است
درستی‌سنجی دسترسی به میانای برنامه‌سازی کاربردی: بررسی کنید که سطح دسترسی به میانای برنامه‌سازی کاربردی پروژه شما به‌درستی با کد توسعه‌دهنده موجود شما مطابقت داشته باشد:
- سطح دسترسی کد توسعه‌دهنده خود را در مرکز API حساب مدیر Google Ads خود پیدا کنید.
- در صفحه نمای کلی Google Ads API، تأیید کنید که پروژه Google Cloud شما همان سطح دسترسی را دارد.
- اگر سطوح دسترسی مطابقت ندارند، لطفاً دوباره برای دسترسی به Google Ads API از صفحه نمای کلی Google Ads API درخواست دهید یا اگر به راهنمایی نیاز دارید با پشتیبانی Google Ads API تماس بگیرید.
نشانی ایمیل تماس میانای برنامه‌سازی کاربردی را به‌روز کنید: به صفحه IAM (مدیریت هویت و دسترسی‌ها) برای پروژه Cloud خود بروید. مطمئن شوید که فهرست کاربران در نقش‌های مالک و ویرایشگر به‌روز باشد. ارسال «اعلان‌های اجباری خدمات» (MSA) را به این نشانی‌های ایمیل شروع خواهیم کرد تا شما را از هرگونه تغییرات آتی در Google Ads API مطلع کنیم.
تغییرات کد: توصیه می‌کنیم کد برنامه‌تان را به‌روز کنید تا ارسال کدهای توسعه‌دهنده به‌عنوان بخشی از فراخوانی‌های میانای برنامه‌سازی کاربردی متوقف شود. نسخه‌های جدیدی از کتابخانه‌های کارخواه را منتشر کرده‌ایم که به شما امکان می‌دهد بدون تنظیم کردن یک توکن توسعه‌دهنده، تماس‌های API برقرار کنید. در نسخه عمده آتی Google Ads API، رد کردن کدهای توسعه‌دهنده در فراخوانی‌های API را شروع خواهیم کرد.
درصورت لزوم، دوباره برای دسترسی به API درخواست دهید: اگر درخواست معلقه شما برای دسترسی به Basic API به‌عنوان بخشی از این انتقال بسته شده است، لطفاً دوباره برای دسترسی به API از صفحه نمای کلی Google Ads API در «کنسول Google Cloud» درخواست دهید.
اسناد به‌روزشده‌ای را منتشر کرده‌ایم تا به شما کمک کنیم این تغییرات را پیمایش کنید. برای مشکلات پشتیبانی فنی، به صفحه پرسشگان ما مراجعه کنید یا با پشتیبانی Google Ads API تماس بگیرید. اگر سؤالی دارید یا می‌خواهید درباره این پست بحث کنید، لطفاً ازطریق سرور Discord انجمن تبلیغات و سنجش Google با ما تماس بگیرید.
- Anash P. Oommen، تیم Google Ads API
برچسب‌ها: google-ads-api، release