کد توسعه‌دهنده رشته‌ای الفباعددی با طول ۲۲ نویسه است که برای متصل کردن برنامه شما به Google Ads API استفاده می‌شود. کدهای توسعه‌دهنده در ۹ سپتامبر ۲۰۲۶ منسوخ شدند. این راهنما تغییرات را خلاصه می‌کند و پرسش‌های متداول درباره این انتقال را فهرست می‌کند تا به توسعه‌دهندگان فعلی کمک کند.
رفتن به نمای کلی Google Ads API در کنسول Cloud
چه چیزی تغییر می‌کند؟
به‌عنوان بخشی از توقف کد توسعه‌دهنده، چندین تغییر در تجربه آماده‌سازی Google Ads API و مدیریت دسترسی API ایجاد کردیم. این بخش تغییرات کلیدی را برجسته می‌کند.
سطوح دسترسی میانای برنامه‌سازی کاربردی با پروژه‌های Google Cloud مرتبط است
در ۹ سپتامبر ۲۰۲۶، توکن‌های توسعه‌دهنده را منسوخ می‌کنیم. سطح دسترسی فعلی و فعال شما به کد توسعه‌دهنده به‌طور خودکار به پروژه‌های Google Cloud شما منتقل شد. این انتقال براساس فعالیت میانای برنامه‌سازی کاربردی در ۹۰ روز قبل‌از توقف ارائه انجام شد. می‌توانید به ارسال کردن کدهای توسعه‌دهنده در سرصفحه‌های فراخوانی میانای برنامه‌سازی کاربردی ادامه دهید، اما این کار اختیاری است و سرورهای میانای برنامه‌سازی کاربردی آن را نادیده می‌گیرند. کد موجودتان بدون هیچ تغییری به کار خود ادامه خواهد داد. سطوح دسترسی میانای برنامه‌سازی کاربردی شما توسط پروژه Google Cloud که برای تولید اطلاعات کاربری OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه‌تان از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این همان پروژه‌ای است که شناسه و رمز کارخواه OAuth شما را دارد.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این همان پروژه‌ای است که حساب خدمات شما را دراختیار دارد.
تجربه ثبت‌نام جدید برای Google Ads API
می‌توانید مستقیماً در 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» دردسترس است.
همچنان می‌توانید به صفحه مرکز 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 استفاده کرده‌اید.
- سطح دسترسی پروژه Google Cloud خود را پس‌از ۹ سپتامبر ۲۰۲۶ به «کاوشگر»، «پایه»، یا «استاندارد» ارتقا داده‌اید.
- فراخوانی‌های میانای برنامه‌سازی کاربردی شما به حساب تولید با
AUTHORIZATION_ERRORناموفق است. فراخوان‌های میانای برنامه‌سازی کاربردی به حساب‌های آزمایشی موفقیت‌آمیز است.
وضعیت
ما راه‌حلی برای این مشکل داریم و درحال تلاش برای عرضه آن به سرورهایمان هستیم. وقتی اصلاحیه فعال شود، فراخوان‌های میانای برنامه‌سازی کاربردی شما دوباره کار خواهند کرد.
راه‌حل موقت
می‌توانید از پروژه Google Cloud جدیدی برای درخواست دسترسی Explorer استفاده کنید.
پرسشگان
بخش زیر پاسخ پرسش‌های متداول درباره توقف ارائه کد توسعه‌دهنده و سطوح دسترسی به API را ارائه می‌دهد.
چه اتفاقی برای سطوح دسترسی میانای برنامه‌سازی کاربردی می‌افتد؟
سطوح دسترسی میانای برنامه‌سازی کاربردی همچنان در Google Ads API اعمال می‌شود. بااین‌حال، این محدودیت‌ها به‌جای کد توسعه‌دهنده شما، به پروژه «کنسول Google Cloud» شما اعطا می‌شود. وقتی فراخوانی‌های میانای برنامه‌سازی کاربردی را انجام می‌دهید، سطوح دسترسی میانای برنامه‌سازی کاربردی شما توسط پروژه Google Cloud که برای تولید اطلاعات کاربری OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه‌تان از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این همان پروژه‌ای است که شناسه و رمز کارخواه OAuth شما را دارد.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این همان پروژه‌ای است که حساب خدمات شما را دراختیار دارد.
پروژه‌ها چگونه برای انتقال سطوح دسترسی به میانای برنامه‌سازی کاربردی شناسایی شدند؟
اگر پیش‌از ۹ سپتامبر ۲۰۲۶، ازقبل یک کد توسعه‌دهنده تأییدشده داشتید، سطوح دسترسی آن به‌صورت زیر به پروژه‌های Google Cloud شما منتقل شده است:
- گزارش‌های فراخوانی میانای برنامه‌سازی کاربردی را برای ۹۰ روز گذشته بررسی کردیم تا مشخص کنیم کدام پروژه‌های Cloud برای فراخوانی میانای برنامه‌سازی کاربردی بااستفاده از کد توسعه‌دهنده تأییدشده شما استفاده شده‌اند.
- سطوح دسترسی API مربوط به کد توسعه‌دهنده را به همه پروژه‌های Cloud شناسایی‌شده اختصاص دادیم.
آیا پس‌از این تغییر می‌توانم چندین پروژه Cloud با سطوح دسترسی مختلف داشته باشم؟
بله، می‌توانید چندین پروژه Google Cloud با سطوح دسترسی مختلف به میانای برنامه‌سازی کاربردی داشته باشید. برای مثال، می‌توانید یک پروژه Google Cloud با دسترسی «پایه» و پروژه Google Cloud دیگری با دسترسی «استاندارد» داشته باشید.
مثال
به‌عنوان مثال، فرض کنید ۴ کلید توسعه‌دهنده و ۶ پروژه Cloud با جزئیات زیر دارید:
- کد توسعه‌دهنده ۱:
abcdefghijkl1234567890دسترسی استاندارد دارد. با شناسه‌های پروژه زیر استفاده شده است:1234567890،5678912345،45678912345. - کد توسعه‌دهنده ۲:
xyzabcdefghi6789012345دسترسی «پایه» دارد. با شناسه‌های پروژه زیر استفاده شده است:1231235678. - کد توسعه‌دهنده ۳:
asdfgflkjhjz7654321012دسترسی «پایه» دارد، اما هرگز برای برقراری تماس API استفاده نشده است. در ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده است. - Developer Token 4:
qwertypoiuyu6543298790had Standard access, but it hasn't been used in the last 90 days. شناسه پروژه9876564900بیش‌از ۹۰ روز پیش با این کد توسعه‌دهنده استفاده شده است. - پروژه Cloud: شناسه پروژه Cloud:
7171234567هرگز با هیچ‌کدام از ژتون‌های توسعه‌دهنده برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نشده است.
سطوح دسترسی میانای برنامه‌سازی کاربردی از کدهای توسعه‌دهنده به پروژه‌های 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 پروژه‌ام را ببینم؟
می‌توانید سطح دسترسی میانای برنامه‌سازی کاربردی پروژه Google Cloud خود را در صفحه نمای کلی Google Ads API ببینید.
چگونه می‌توانم برای سطوح دسترسی بالاتر به میانای برنامه‌سازی کاربردی درخواست دهم؟
می‌توانید برای سطوح دسترسی به میانای برنامه‌سازی کاربردی بالاتر برای پروژه Google Cloud خود از صفحه نمای کلی Google Ads 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 درخواست دهید. نمونه‌ای را ببینید.
در هر دو مورد، می‌توانید برای دسترسی Explorer و برنامه‌های سطح دسترسی Basic درخواست دهید و آن‌ها به‌طور خودکار بازبینی می‌شوند؛ دیگر لازم نیست برای تکمیل فرایند بازبینی با تیم «رعایت مقررات» 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 API در پروژه Google Cloud انجام دهید.
آیا برای استفاده از Google Ads API همچنان به حساب مدیر Google Ads نیاز دارم؟
دیگر برای استفاده از Google Ads API به حساب مدیر Google Ads نیاز ندارید. فقط درصورتی به حساب مدیر نیاز دارید که بخواهید بااستفاده از API به چند حساب پیوند دهید و آن‌ها را مدیریت کنید.
توسعه‌دهنده جدید هستم. چگونه برای Google Ads API ثبت‌نام کنم؟
برای ثبت‌نام در Google Ads API، دستورالعمل‌های موجود در راهنمای شروع به کار را دنبال کنید. برای دریافت کد توسعه‌دهنده از «مرکز میانای برنامه‌سازی کاربردی» حساب مدیر Google Ads خودتان ثبت‌نام نکنید؛ این درخواست‌ها پردازش نخواهند شد. «مرکز میانای برنامه‌سازی کاربردی» در آینده نزدیک برچیده خواهد شد.
چه اجازه‌های IAM برای مدیریت سطوح دسترسی API لازم است؟
برای مدیریت سطوح دسترسی Google Ads API، به اجازه‌های مدیریت سهمیه برای پروژه Google Cloud خود نیاز دارید. اجازه‌های لازم به‌طور پیش‌فرض برای نقش‌های زیر لحاظ شده است: «مالک»، «ویرایشگر»، «سرپرست سهمیه»، و «سرپرست استفاده از سرویس». برای اطلاعات بیشتر، مستندات اجازه‌های سهمیه را ببینید.
می‌توانید صفحه IAM را برای پروژه Google Cloud خود بررسی کنید تا نقش‌های اختصاص‌داده‌شده به خود را ببینید. با سرپرست پروژه Google Cloud خود همکاری کنید تا نقش‌های IAM لازم را برای پروژه Google Cloud شما اعطا کند.