کد توسعه‌دهنده رشته‌ای الفباعددی ۲۲ نویسه‌ای است که برای متصل کردن برنامه شما به Google Ads API استفاده می‌شود. توکن‌های توسعه‌دهنده در ۹ سپتامبر ۲۰۲۶ منسوخ شدند. این راهنما تغییرات را خلاصه می‌کند و پرسش‌های متداول درباره این انتقال را فهرست می‌کند تا به توسعه‌دهندگان فعلی کمک کند.
چه چیزی تغییر می‌کند؟
به‌عنوان بخشی از توقف کد توسعه‌دهنده، چندین تغییر در تجربه آماده‌سازی Google Ads API و مدیریت دسترسی API ایجاد کردیم. این بخش تغییرات کلیدی را برجسته می‌کند.
سطوح دسترسی به میانای برنامه‌سازی کاربردی با پروژه‌های Google Cloud مرتبط است
در ۹ سپتامبر ۲۰۲۶، توکن‌های توسعه‌دهنده را منسوخ می‌کنیم. سطح دسترسی فعلی و فعال شما به کد توسعه‌دهنده به‌طور خودکار به پروژه‌های Google Cloud شما منتقل شد. این انتقال براساس فعالیت میانای برنامه‌سازی کاربردی در ۹۰ روز قبل‌از توقف ارائه انجام شد. می‌توانید به ارسال کردن کدهای توسعه‌دهنده در سرصفحه‌های فراخوانی میانای برنامه‌سازی کاربردی ادامه دهید، اما این کار اختیاری است و سرورهای میانای برنامه‌سازی کاربردی آن را نادیده می‌گیرند. کد موجود شما بدون هیچ تغییری به کار خود ادامه خواهد داد. سطوح دسترسی به میانای برنامه‌سازی کاربردی شما براساس پروژه Google Cloud که برای تولید اطلاعات اعتباری OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه‌تان از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این همان پروژه‌ای است که شناسه و رمز کارخواه OAuth شما را دارد.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این پروژه مالک حساب خدمات شما است.
تجربه ثبت‌نام جدید برای «میانای برنامه‌سازی کاربردی Google Ads»
می‌توانید مستقیماً در Google Cloud Console برای دسترسی به Google Ads API ثبت‌نام کنید بدون اینکه به حساب مدیر Google Ads نیاز داشته باشید. برای دریافت کد توسعه‌دهنده از صفحه مرکز API ثبت‌نام نکنید یا برای دسترسی به API از صفحه مرکز API در حساب مدیر Google Ads خود درخواست ندهید، زیرا این فرایندها به «کنسول Google Cloud» منتقل شده‌اند و اگر از صفحه مرکز API شروع شوند، پردازش نخواهند شد.
تجربه جدید مدیریت دسترسی به میانای برنامه‌سازی کاربردی
همه عملکردهای جدید ثبت‌نام و مدیریت دسترسی به میانای برنامه‌سازی کاربردی (API) را، مانند درخواست دسترسی به API و مدیریت سطوح دسترسی به API در صفحه مرکز API در حساب‌های مدیر Google Ads، متوقف کرده‌ایم. این عملکردها درعوض در صفحه «نمای کلی Google Ads API» در Google Cloud Console دردسترس است.
همچنان می‌توانید به صفحه «مرکز API» دسترسی داشته باشید تا به جزئیات توسعه‌دهنده تاریخی خود مراجعه کنید. این صفحه در آینده به‌طور کامل برچیده خواهد شد.
کدهای خطای جدید
در نسخه ۲۵ و جدیدتر، اگر بخواهید از پروژه Google Cloud با
دسترسی آزمایشی برای برقراری تماس با حساب تولید استفاده کنید، Google Ads API
خطای AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
را نشان می‌دهد. نسخه‌های قدیمی‌تر
API (نسخه ۲۴ و قدیمی‌تر) به‌جای آن خطای
AuthorizationError.ACTION_NOT_PERMITTED ارائه می‌دهند. اگر
با این خطا مواجه شدید، به
صفحه نمای کلی Google Ads API برای پروژه Google Cloud خود بروید
و برای دسترسی Explorer درخواست دهید.
درستی‌سنجی نمانام برای دسترسی «پایه» و «استاندارد» الزامی است
برای درخواست‌های دسترسی «پایه» و «استاندارد» جدید، باید درستی‌سنجی نمانام را برای پروژه Google Cloud خود تکمیل کنید. دارندگان دسترسی فعلی ملزم به تکمیل درستی‌سنجی نمانام نیستند، اما این کار توصیه می‌شود.
برنامه‌های دسترسی پایه خودکار هستند و ظرف چند دقیقه پس‌از درستی‌سنجی و ارسال نمانام بررسی خواهند شد.
به‌دلیل این به‌روزرسانی‌های فرایند، همه درخواست‌های دسترسی «پایه» معلقه به‌عنوان بخشی از این انتقال بسته می‌شوند. درخواست‌کنندگان تحت‌تأثیر قرارگرفته ایمیلی حاوی جزئیات دریافت می‌کنند و باید از صفحه نمای کلی Google Ads API دوباره برای دسترسی «پایه» درخواست دهند.
رایانامه‌های تماس جدید میانای برنامه‌سازی کاربردی
هم‌زمان با آماده شدن برای برچیدن صفحه «مرکز API»، از فهرست کاربران مالک و ویرایشگر در پروژه Google Cloud شما به‌عنوان تنها کانال ارتباطات اداری و الزامات رعایت استانداردها استفاده خواهیم کرد. برای اطمینان از انتقال روان، به‌طور موقت به ارسال اعلان‌های خدمات اجباری (MSAs) به نشانی ایمیل فهرست‌شده در «مرکز API» شما ادامه خواهیم داد. همچنان که انتقال کانال‌های ارتباطی خود را نهایی می‌کنیم، شما را در جریان خواهیم گذاشت.
اگر توسعه‌دهنده فعلی هستید چه کاری باید انجام دهید
سطوح دسترسی میانای برنامه‌سازی کاربردی پروژه Google Cloud خود را مرور کنید: اگر توسعه‌دهنده فعلی هستید، اکیداً توصیه می‌کنیم صفحه نمای کلی Google Ads API پروژه‌های Google Cloud خود را مرور کنید تا مطمئن شوید که همان سطح دسترسی میانای برنامه‌سازی کاربردی کد توسعه‌دهنده فعلی شما را دارند. برای رفع هرگونه مغایرتی که ممکن است پیدا کنید، دستورالعمل‌های این راهنما را دنبال کنید.
نشانی ایمیل مخاطب API خود را مرور کنید: به صفحه IAM (مدیریت هویت و دسترسی) برای پروژه Google Cloud خود بروید. تأیید کنید که توسعه‌دهندگان و مدیران حساب Ads فعال شما در پروژه Google Cloud شما نقش‌های مالک یا ویرایشگر مناسب را دارند. برای اطلاع‌رسانی به شما درباره هرگونه تغییر آتی در Google Ads API، ارسال «اعلامیه‌های اجباری خدمات» (MSA) را به این نشانی‌های ایمیل شروع خواهیم کرد. برای مدتی موقت، به ارسال «قراردادهای خدمات اصلی» به نشانی ایمیل تماس فهرست‌شده در مرکز API شما ادامه خواهیم داد و هر زمان که این فرایند به‌روز شود به شما اطلاع خواهیم داد.
کد برنامه‌تان را اصلاح کنید: توصیه می‌کنیم برنامه‌تان را به‌روز کنید تا ارسال کد توسعه‌دهنده به‌عنوان بخشی از فراخوانی‌های میانای برنامه‌سازی کاربردی متوقف شود. نسخه‌های به‌روزشده‌ای از کتابخانه‌های مشتری، سرور Google Ads MCP، و دستیار توسعه‌دهنده Google Ads API منتشر کرده‌ایم که به شما امکان می‌دهد بدون تنظیم کد توسعه‌دهنده، تماس‌های API برقرار کنید. در نسخه اصلی آینده Google Ads API، شروع به رد کردن کدهای توسعه‌دهنده در تماس‌های API خواهیم کرد. اگر برنامه‌تان از این کتابخانه‌ها استفاده می‌کند، وابستگی‌های برنامه‌تان را به‌روز کنید تا از جدیدترین نسخه استفاده کند.
اگر به کمک بیشتری نیاز دارید یا سؤالات بیشتری دارید، با پشتیبانی Google Ads API تماس بگیرید.
مشکلات شناخته‌شده
این بخش همه مشکلات شناخته‌شده مربوط به توقف تدریجی کدهای توسعه‌دهنده را مستند می‌کند.
کاربران حتی پس‌از تکمیل درستی‌سنجی نمانام، دسترسی «کاوشگر» یا دسترسی «پایه» دریافت نمی‌کنند
از مشکلی مطلع هستیم که در آن برخی‌از کاربران دارای پروژه‌های درستی‌سنجی‌شده نمانام هنگام درخواست برای دسترسی «پایه» رد می‌شوند. کاربران ایمیل رد شدن دریافت خواهند کرد که می‌گوید «دسترسی پایه نیازمند نمایه نمانام OAuth درستی‌سنجی‌شده موفق است. درخواستتان تأیید نشد زیرا درستی‌سنجی نمانام را برای پروژه‌تان تکمیل نکرده‌اید." به‌همین ترتیب، برخی‌از کاربرانی که برای دسترسی به Explorer ثبت‌نام می‌کنند نیز با ایمیل رد درخواست مواجه می‌شوند که می‌گوید «درحال‌حاضر نمی‌توانیم دسترسی Explorer را به پروژه Google Cloud شما اعطا کنیم زیرا معیارهای واجدشرایط بودن لازم برای دسترسی مستقیم به حساب تولید تحت «خط‌مشی‌ها و شرایط خدمات Google Ads API» ما را برآورده نمی‌کند.»
علت ریشه‌ای
پروژه Google Cloud شما ممکن است در برنامه «آزمایشی رایگان Google Cloud» باشد یا حساب صورت‌حساب تعلیق‌شده یا غیرفعال داشته باشد.
نحوه درستی‌سنجی
وضعیت صورت‌حساب Google Cloud خود را بررسی کنید. اگر پروژه صورت‌حساب شما به‌عنوان «حساب دوره آزمایشی رایگان» نشان داده می‌شود یا در وضعیت تعلیق یا غیرفعال است، تحت تأثیر این مشکل قرار گرفته‌اید.
وضعیت
علت اصلی را شناسایی کرده‌ایم و درحال کار روی رفع این مشکل هستیم.
راه‌حل موقت
چند راهکار برای حل این مشکل وجود دارد. مناسب‌ترین گزینه را برای مورد استفاده‌تان انتخاب کنید.
ارتقا دادن پروژه Google Cloud به سطح پولی
پروژه Google Cloud خود را به سطح پولی ارتقا دهید. چند دقیقه صبر کنید و دوباره برای دسترسی «پایه» درخواست دهید.
برداشتن صورت‌حساب برای پروژه Google Cloud
اگر سرویس‌های دیگری در پروژه Google Cloud شما اجرا نمی‌شود، صورت‌حساب پروژه Google Cloud خود را بردارید. چند دقیقه صبر کنید و دوباره برای دسترسی «پایه» درخواست دهید.
استفاده از پروژه Google Cloud دیگر
اگر پروژه Google Cloud دیگری دارید که نمانام آن تأیید شده است، از آن پروژه برای درخواست «دسترسی پایه» استفاده کنید.
پروژه‌هایی که سطح دسترسی «پایه» یا «کاوشگر» آن‌ها به‌تازگی تأیید شده است، AUTHORIZATION_ERROR دریافت می‌کنند
از مشکلی مطلع هستیم که در آن برخی‌از کاربرانی که سطح دسترسی پروژه Google Cloud خود را پس‌از ۹ سپتامبر ۲۰۲۶ به سطح دسترسی تأییدشده «پایه» یا «کاوشگر» ارتقا داده‌اند، هنگام برقراری تماس‌های Google Ads API با حساب‌های تولید، AUTHORIZATION_ERROR دریافت می‌کنند.
علت اصلی
Google Ads API ارتقاهای سطح دسترسی API را که از «کنسول Google Cloud» برای برخی پروژه‌ها تکمیل شده است رعایت نمی‌کند.
نحوه درستی‌سنجی
اگر همه شرایط زیر درست باشد، تحت تأثیر این مشکل قرار گرفته‌اید:
- کد توسعه‌دهنده با سطح دسترسی «آزمایشی» دارید.
- قبل‌از ۹ سپتامبر ۲۰۲۶، از پروژه Google Cloud و کد توسعه‌دهنده خود برای انجام تماس‌های Google Ads API API استفاده کرده‌اید.
- سطح دسترسی پروژه Google Cloud خود را پس‌از ۹ سپتامبر ۲۰۲۶ به «کاوشگر»، «دسترسی پایه»، یا «دسترسی استاندارد» ارتقا داده باشید.
- فراخوانی‌های میانای برنامه‌سازی کاربردی شما به حساب تولید با
AUTHORIZATION_ERRORناموفق است. فراخوان‌های میانای برنامه‌سازی کاربردی به حساب‌های آزمایشی موفقیت‌آمیز است.
وضعیت
ما راه‌حلی برای این مشکل داریم و درحال تلاش برای عرضه آن به سرورهایمان هستیم. وقتی اصلاحیه فعال شود، فراخوان‌های میانای برنامه‌سازی کاربردی شما دوباره کار خواهند کرد.
راه‌حل موقت
می‌توانید از پروژه Google Cloud جدیدی برای درخواست دسترسی Explorer استفاده کنید.
پرسشگان
بخش زیر پاسخ پرسش‌های متداول درباره توقف ارائه کد توسعه‌دهنده و سطوح دسترسی به API را ارائه می‌دهد.
چه اتفاقی برای سطوح دسترسی API می‌افتد؟
سطوح دسترسی میانای برنامه‌سازی کاربردی همچنان در Google Ads API اعمال می‌شود. بااین‌حال، این مجوزها به‌جای توکن توسعه‌دهنده به پروژه «کنسول Google Cloud» شما اعطا می‌شود. وقتی فراخوانی‌های میانای برنامه‌سازی کاربردی را انجام می‌دهید، سطوح دسترسی میانای برنامه‌سازی کاربردی شما توسط پروژه Google Cloud که برای تولید اطلاعات کاربری OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه‌تان از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این همان پروژه‌ای است که شناسه و رمز کارخواه OAuth شما را دارد.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این همان پروژه‌ای است که حساب خدمات شما را دراختیار دارد.
پروژه‌ها چگونه برای انتقال سطوح دسترسی به «میانای برنامه‌سازی کاربردی» شناسایی شدند؟
اگر ازقبل از ۹ سپتامبر ۲۰۲۶ یک کد توسعه‌دهنده تأییدشده داشتید، سطوح دسترسی آن به پروژه‌های Google Cloud شما به شرح زیر منتقل شده است:
- گزارش‌های فراخوانی میانای برنامه‌سازی کاربردی را برای ۹۰ روز گذشته بررسی کردیم تا مشخص کنیم کدام پروژه‌های Cloud برای فراخوانی میانای برنامه‌سازی کاربردی بااستفاده از کد توسعه‌دهنده تأییدشده شما استفاده شده‌اند.
- سطوح دسترسی API مربوط به کد توسعه‌دهنده را به همه پروژه‌های Cloud شناسایی‌شده اختصاص دادیم.
آیا پس‌از این تغییر می‌توانم چندین پروژه Cloud با سطوح دسترسی مختلف داشته باشم؟
بله، می‌توانید چندین پروژه Google Cloud با سطوح دسترسی متفاوت به API داشته باشید. برای مثال، می‌توانید یک پروژه Google Cloud با دسترسی «پایه» و پروژه Google Cloud دیگری با دسترسی «استاندارد» داشته باشید.
مثال
به‌عنوان مثال، فرض کنید ۴ کلید توسعه‌دهنده و ۶ پروژه Cloud با جزئیات زیر دارید:
- کد توسعه‌دهنده ۱:
abcdefghijkl1234567890دسترسی «استاندارد» دارد. با شناسه‌های پروژه زیر استفاده شده است:1234567890،5678912345،45678912345. - کد توسعه‌دهنده ۲:
xyzabcdefghi6789012345دسترسی «پایه» دارد. با شناسه‌های پروژه زیر استفاده شده است:1231235678. - کد توسعه‌دهنده ۳:
asdfgflkjhjz7654321012دسترسی «پایه» دارد، اما هرگز برای برقراری تماس API استفاده نشده است. این مجوز ظرف ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده باشد. - Developer Token 4:
qwertypoiuyu6543298790دسترسی «استاندارد» داشت، اما در ۹۰ روز گذشته از آن استفاده نشده است. شناسه پروژه9876564900بیش‌از ۹۰ روز پیش با این کد توسعه‌دهنده استفاده شده است. - پروژه Cloud: شناسه پروژه Cloud:
7171234567هرگز با هیچ‌کدام از ژتون‌های توسعه‌دهنده برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نشده است.
سطوح دسترسی API از کدهای توسعه‌دهنده به پروژه‌های Google Cloud به‌صورت زیر منتقل خواهد شد:
| کد توسعه‌دهنده | شناسه پروژه | سطح دسترسی | توضیح |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
دسترسی استاندارد | نشان توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 |
5678912345 |
دسترسی استاندارد | نشان توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 |
45678912345 |
دسترسی استاندارد | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
xyzabcdefghi6789012345 |
1231235678 |
دسترسی پایه | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
asdfgflkjhjz7654321012 |
-- |
-- |
دسترسی به میانای برنامه‌سازی کاربردی کد توسعه‌دهنده به هیچ پروژه‌ای منتقل نشد چون هرگز برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نشده بود. |
qwertypoiuyu6543298790 |
9876564900 |
دسترسی آزمایشی | دسترسی به «میانای برنامه‌سازی کاربردی» رمز توسعه‌دهنده به‌دلیل عدم فعالیت به‌مدت ۹۰ روز باطل شد. سطح دسترسی API پروژه به‌طور پیش‌فرض روی دسترسی «آزمایشی» تنظیم شده است. |
-- |
7171234567 |
دسترسی آزمایشی | این پروژه جدیدی است که با هیچ‌کدام از نشان‌های توسعه‌دهنده استفاده نشده است. سطح دسترسی API پروژه به‌طور پیش‌فرض روی «دسترسی آزمایشی» تنظیم شده است. |
بیش‌از یک کد توسعه‌دهنده تأییدشده دارم. سطوح دسترسی API را به کدام پروژه منتقل می‌کنید؟
سطوح دسترسی هر کد توسعه‌دهنده تأییدشده به پروژه‌های Google Cloud مرتبط با آن کد توسعه‌دهنده منتقل می‌شود. نمونه‌ای را ببینید.
از چند پروژه Google Cloud استفاده می‌کنم. سطوح دسترسی API را به کدام پروژه منتقل می‌کنید؟
اگر در ۹۰ روز گذشته از چند پروژه Google Cloud با کد توسعه‌دهنده تأییدشده‌تان استفاده کرده‌اید، همه آن پروژه‌ها سطوح دسترسی به API یکسانی با کد توسعه‌دهنده شما دریافت خواهند کرد. نمونه را ببینید.
سطوح دسترسی API به پروژه‌ای اختصاص داده شده است که دیگر از آن استفاده نمی‌کنم. چگونه این مشکل را برطرف کنم؟
اگر دسترسی به Google Ads API به پروژه Google Cloud که دیگر از آن استفاده نمی‌کنید اختصاص داده شده است، نیازی به اقدام اضافی ازسوی شما نیست. Google دسترسی به میانای برنامه‌سازی کاربردی را برای پروژه استفاده‌نشده پس‌از ۹۰ روز عدم فعالیت لغو خواهد کرد.
سطوح دسترسی API به پروژه Google Cloud من اختصاص داده نشده است. چگونه این مشکل را برطرف کنم؟
پروژه Google Cloud شما سطح دسترسی کد توسعه‌دهنده‌تان را به ارث نبرده است، احتمالاً به این دلیل که هرگز از کد توسعه‌دهنده و پروژه Cloud برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نکرده‌اید، یا دسترسی میانای برنامه‌سازی کاربردی کد توسعه‌دهنده‌تان به‌دلیل عدم فعالیت منقضی شده است. برای رفع مشکل، از صفحه نمای کلی Google Ads API برای سطح دسترسی API مناسب برای آن پروژه درخواست دهید. مثالی ببینید.
کجا می‌توانم سطوح دسترسی API پروژه‌ام را ببینم؟
می‌توانید سطح دسترسی API پروژه Google Cloud خود را در صفحه «نمای کلی Google Ads API» ببینید.
چگونه برای سطوح دسترسی بالاتر به API درخواست دهم؟
می‌توانید برای سطوح دسترسی به میانای برنامه‌سازی کاربردی بالاتر برای پروژه Google Cloud خود از صفحه نمای کلی Google Ads API درخواست دهید.
چه اتفاقی برای درخواست دسترسی به API معلق من می‌افتد؟
هرگونه درخواست معلقه «دسترسی پایه» که قبل‌از ۹ سپتامبر ۲۰۲۶ از «مرکز API» حساب مدیر Google Ads خود آغاز کرده‌اید بسته خواهد شد. باید از صفحه «نمای کلی Google Ads API» پروژه Google Cloud خود دوباره برای دسترسی «پایه» درخواست دهید. اگر تحت تأثیر این تغییر قرار بگیرید، ایمیلی حاوی دستورالعمل‌های لازم دریافت خواهید کرد.
هرگونه درخواست دسترسی «استاندارد» معلقی که از ۹ سپتامبر ۲۰۲۶ از «مرکز میانای برنامه‌سازی کاربردی» حساب مدیر Google Ads خود شروع کرده‌اید، طبق معمول بررسی خواهد شد. درصورت تأیید، پروژه Google Cloud مرتبط با رمز توسعه‌دهنده شما دسترسی «استاندارد» دریافت خواهد کرد.
آیا می‌توانم رمز توسعه‌دهنده تأییدشده‌ام را دوباره با پروژه Google Cloud جدیدی مرتبط کنم؟
قبل‌از ۹ سپتامبر ۲۰۲۶، تیم Google Ads API از مرتبط کردن مجدد یک کد توسعه‌دهنده با یک پروژه جدید Google Cloud به‌صورت موردی پشتیبانی می‌کرد. این از ۹ سپتامبر ۲۰۲۶ دیگر پشتیبانی نمی‌شود، زیرا ما توکن‌های توسعه‌دهنده را منسوخ کرده‌ایم. اگر لازم است از پروژه Google Cloud جدیدی استفاده کنید، باید برای دسترسی مناسب به Google Ads API از صفحه نمای کلی Google Ads API پروژه Google Cloud خود درخواست دهید.
یک کد توسعه‌دهنده تأییدشده دارم، اما هرگز از آن استفاده نکرده‌ام. آیا می‌توانم از این کد توسعه‌دهنده استفاده کنم؟
نه، نمی‌توانید از این توکن توسعه‌دهنده استفاده کنید. دو احتمال وجود دارد:
ممکن است دسترسی به کد توسعه‌دهنده شما به‌دلیل عدم فعالیت لغو شود: طبق خط‌مشی‌های Google، اگر از کد API شما به‌مدت ۹۰ روز متوالی استفاده نشود، Google ممکن است آن را لغو کند. اگر مدتی است از کد توسعه‌دهنده خود استفاده نکرده‌اید، احتمالاً سطح دسترسی آن به‌دلیل عدم فعالیت لغو شده است. اگر این‌طور است، دوباره برای دسترسی به میانای برنامه‌سازی کاربردی برای پروژه Google Cloud خود از صفحه نمای کلی میانای برنامه‌سازی کاربردی Google Ads درخواست دهید. نمونه را ببینید.
نمانام توسعه‌دهنده شما در ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده است، اما هرگز از آن استفاده نکرده‌اید: ازآنجایی‌که هرگز از نمانام توسعه‌دهنده تأییدشده‌تان با پروژه Google Cloud قبل‌از ۹ سپتامبر ۲۰۲۶ استفاده نکرده‌اید، سطوح دسترسی آن به پروژه Cloud منتقل نشده است. درنتیجه، دیگر نمی‌توانید از کد توسعه‌دهنده خود استفاده کنید. اگر بخواهید با این ژتون توسعه‌دهنده، فراخوانی میانای برنامه‌سازی کاربردی به حساب تولید انجام دهید، خطای
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONرا نشان خواهیم داد. برای برطرف کردن این خطا، ازطریق صفحه «نمای کلی Google Ads API» در پروژه Google Cloud خود، برای دسترسی مناسب به Google Ads API درخواست دهید. نمونه‌ای را ببینید.
در هر دو این موارد، می‌توانید برای دسترسی «کاوشگر» و سطح دسترسی «پایه» درخواست دهید و درخواست‌هایتان به‌طور خودکار بررسی شود؛ دیگر لازم نیست برای تکمیل فرایند بررسی با «تیم رعایت استانداردها» در Google همکاری کنید. اگر به دسترسی «استاندارد» نیاز دارید، باید بازبینی دستی انجام شود. بااین‌حال، می‌توانید جزئیات کد توسعه‌دهنده تأییدشده‌تان را هنگام درخواست برای دسترسی «استاندارد» هم‌رسانی کنید تا تیم «رعایت مقررات» بتواند درخواست دسترسی «استاندارد» جدیدتان را براساس آن بازبینی کند.
آیا می‌توانم ارسال کد توسعه‌دهنده را به‌عنوان بخشی از درخواست‌های API متوقف کنم؟
بله، می‌توانید ارسال کدهای توسعه‌دهنده را به‌عنوان بخشی از درخواست‌های API متوقف کنید. اگر از کتابخانه کارخواه استفاده می‌کنید، ممکن است لازم باشد آن را به جدیدترین نسخه ارتقا دهید. گزارش‌های تغییر کتابخانه را بررسی کنید تا مطمئن شوید که از برقراری تماس‌های API بدون مشخص کردن یک توکن توسعه‌دهنده پشتیبانی می‌کند.
من بخشی از برنامه آزمایشی سطح دسترسی مدیریت‌شده Cloud بودم. چگونه تحت تأثیر قرار می‌گیرم؟
برنامه آزمایشی سطح دسترسی مدیریت‌شده Cloud به‌عنوان روشی برای توسعه‌دهندگان Google Cloud معرفی شد تا بتوانند بدون ارسال کردن یک نمانام توسعه‌دهنده به‌عنوان بخشی از درخواست API، فراخوانی‌های API را انجام دهند. اکنون که توکن‌های توسعه‌دهنده را منسوخ کرده‌ایم، این برنامه متوقف خواهد شد.
سطوح دسترسی کد توسعه‌دهنده فعال شما به پروژه Google Cloud شما منتقل شده است، بنابراین کد موجود شما باید بدون هیچ تغییری به کار خود ادامه دهد. اگر لازم است از پروژه Google Cloud جدیدی استفاده کنید، باید از صفحه نمای کلی Google Ads API پروژه Google Cloud خود برای دسترسی به API درخواست دهید.
کد توسعه‌دهنده من بخشی از فهرست مجازها بود. این موضوع چه تأثیری بر من دارد؟
Google ممکن است برنامه‌های آزمایشی‌ای اجرا کند که به برخی‌از توسعه‌دهندگان امکان دسترسی به ویژگی‌های آزمایشی را می‌دهد. دسترسی به این ویژگی‌ها گاهی با افزودن کد توسعه‌دهنده شما به فهرست مجاز ارائه می‌شود. اگر بخشی از چنین برنامه آزمایشی بودید، نیازی به اقدام از طرف شما نیست.
همه برنامه‌های آزمایشی را به‌روزرسانی کرده‌ایم تا به‌جای استفاده از کدهای توسعه‌دهنده به‌عنوان سازوکار فهرست مجاز، از پروژه‌های Google Cloud استفاده کنند و وضعیت فهرست مجاز کد توسعه‌دهنده را به پروژه‌های Google Cloud مرتبط منتقل کرده‌ایم. کد موجود شما باید بدون هیچ تغییری به کار خود ادامه دهد. اگر همچنان با مشکل مواجه هستید، با مدیر «حساب Google» خود که شما را در برنامه آزمایشی ثبت‌نام کرده است تماس بگیرید.
یک نمانام توسعه‌دهنده تأییدشده دارم و می‌خواهم از آن با پروژه Google Cloud جدیدی استفاده کنم. آیا این کار مجاز است؟
نه، نمی‌توانید از پروژه Google Cloud جدیدی با کد توسعه‌دهنده تأییدشده‌تان استفاده کنید. چون هرگز از کد توسعه‌دهنده تأییدشده‌تان با پروژه جدید Google Cloud قبل‌از ۹ سپتامبر ۲۰۲۶ استفاده نکرده‌اید، سطوح دسترسی آن به پروژه Cloud منتقل نشده است. اگر تلاش کنید با این کد توسعه‌دهنده فراخوانی API انجام دهید، خطای CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION را نشان خواهیم داد، زیرا دیگر از کدهای توسعه‌دهنده برای تعیین سطوح دسترسی API شما استفاده نمی‌شود. برای برطرف کردن این خطا، ازطریق صفحه «نمای کلی Google Ads API» در پروژه Google Cloud خود، برای دسترسی به میانای برنامه‌سازی کاربردی مناسب درخواست دهید. نمونه را ببینید.
کد توسعه‌دهنده من در خارج از سازمان لو رفته است. آیا باید توکن توسعه‌دهنده خود را بازنشانی کنم؟
نه، در این مورد نیازی به بازنشانی کردن کد توسعه‌دهنده ندارید. ازآنجایی‌که سطوح دسترسی میانای برنامه‌سازی کاربردی برای کد توسعه‌دهنده شما را به پروژه Google Cloud منتقل کرده‌ایم، کاربر غیرمجاز دیگر نمی‌تواند از کد توسعه‌دهنده شما با پروژه Google Cloud خودش استفاده کند.
چه اتفاقی برای API Center می‌افتد؟
صفحه موجود «مرکز API» در حساب مدیر Google Ads منسوخ شده است و در آینده نزدیک برداشته خواهد شد. اگر ازقبل کد توسعه‌دهنده دارید، همچنان می‌توانید به سیستم حساب مدیر Google Ads خود وارد شوید و جزئیات را مشاهده کنید. بااین‌حال، این‌ها فقط برای مرجع شما ارائه شده‌اند. هیچ کاری دررابطه‌با سطوح دسترسی به کد توسعه‌دهنده، مثل درخواست برای سطوح دسترسی بالاتر به میانای برنامه‌سازی کاربردی، از این صفحه انجام ندهید.
اگر نیاز دارید برای سطوح دسترسی بالاتر به «میانای برنامه‌سازی کاربردی» درخواست دهید، باید این کار را از صفحه «نمای کلی میانای برنامه‌سازی کاربردی Google Ads» پروژه Google Cloud خود انجام دهید.
آیا برای استفاده از Google Ads API همچنان به حساب مدیر Google Ads نیاز دارم؟
دیگر برای استفاده از Google Ads API به حساب مدیر Google Ads نیاز ندارید. فقط درصورتی به حساب مدیر نیاز دارید که بخواهید بااستفاده از API به چند حساب پیوند دهید و آن‌ها را مدیریت کنید.
توسعه‌دهنده جدید هستم. چگونه برای Google Ads API ثبت‌نام کنم؟
برای ثبت‌نام در Google Ads API، دستورالعمل‌های موجود در راهنمای شروع به کار را دنبال کنید. از «مرکز API» حساب مدیر Google Ads خود برای دریافت کد توسعه‌دهنده ثبت‌نام نکنید؛ این برنامه‌ها پردازش نخواهند شد. «مرکز میانای برنامه‌سازی کاربردی» در آینده نزدیک برچیده خواهد شد.
چه اجازه‌های IAM برای مدیریت سطوح دسترسی API لازم است؟
برای مدیریت سطوح دسترسی Google Ads API، به اجازه‌های مدیریت سهمیه برای پروژه Google Cloud خود نیاز دارید. اجازه‌های لازم به‌طور پیش‌فرض برای نقش‌های زیر لحاظ شده است: «مالک»، «ویرایشگر»، «سرپرست سهمیه»، و «سرپرست استفاده از سرویس». برای اطلاعات بیشتر، مستندات اجازه‌های سهمیه را ببینید.
برای دیدن نقش‌های اختصاص‌یافته، می‌توانید صفحه IAM را برای پروژه Google Cloud خود بررسی کنید. با سرپرست پروژه Google Cloud خود همکاری کنید تا نقش‌های IAM لازم را برای پروژه Google Cloud شما اعطا کند.