کد توسعه‌دهنده رشته‌ای الفباعددی با ۲۲ نویسه است که برای متصل کردن برنامه شما به Google Ads API استفاده می‌شود. کدهای توسعه‌دهنده در ۹ سپتامبر ۲۰۲۶ منسوخ شدند. این راهنما تغییرات را خلاصه می‌کند و پرسش‌های متداول درباره این انتقال را برای کمک به توسعه‌دهندگان فعلی فهرست می‌کند.
رفتن به نمای کلی Google Ads API در Cloud Console
چه چیزی تغییر می‌کند؟
ما چندین تغییر در تجربه آماده‌سازی 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 Console منتقل شده‌اند و اگر از صفحه مرکز 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 شما ارسال خواهیم کرد و هر زمان که این فرایند به‌روز شود به شما اطلاع خواهیم داد.
کد برنامه‌تان را اصلاح کنید: توصیه می‌کنیم برنامه‌تان را به‌روز کنید تا ارسال کد توسعه‌دهنده به‌عنوان بخشی از فراخوانی‌های میانای برنامه‌سازی کاربردی متوقف شود. نسخه‌های به‌روزشده‌ای از کتابخانه‌های کارخواه، سرور MCP Google Ads، و دستیار توسعه‌دهنده Google Ads API را منتشر کرده‌ایم که به شما امکان می‌دهد بدون تنظیم کد توسعه‌دهنده، تماس‌های API برقرار کنید. در نسخه عمده آتی Google Ads API، رد کردن کدهای توسعه‌دهنده در فراخوانی‌های API را شروع خواهیم کرد. اگر برنامه‌تان از این کتابخانه‌ها استفاده می‌کند، وابستگی‌های برنامه‌تان را به‌روز کنید تا از جدیدترین نسخه استفاده کند.
اگر به کمک بیشتری نیاز دارید یا سؤالات بیشتری دارید، با پشتیبانی Google Ads API تماس بگیرید.
مشکلات شناخته‌شده
این بخش همه مشکلات شناخته‌شده مربوط به توقف تدریجی توکن‌های توسعه‌دهنده را مستند می‌کند.
کاربران حتی پس‌از تکمیل درستی‌سنجی «نمانام» دسترسی «کاوشگر» یا دسترسی «پایه» دریافت نمی‌کنند
از مشکلی مطلع هستیم که در آن برخی‌از کاربران دارای پروژه‌های درستی‌سنجی‌شده نمانام هنگام درخواست برای دسترسی «پایه» رد می‌شوند. کاربران ایمیل ردی دریافت خواهند کرد که می‌گوید «دسترسی پایه» به نمایه نمانام OAuth درستی‌سنجی‌شده موفق نیاز دارد. درخواستتان تأیید نشد چون درستی‌سنجی نمانام را برای پروژه‌تان تکمیل نکرده‌اید.» به‌طور مشابه، برخی‌از کاربرانی که برای دسترسی «کاوشگر» ثبت‌نام می‌کنند نیز رد می‌شوند و ایمیل ردی دریافت می‌کنند که می‌گوید: «درحال‌حاضر نمی‌توانیم دسترسی «کاوشگر» را به پروژه 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 Console برای برخی پروژه‌ها تکمیل شده‌اند رعایت نمی‌کند.
نحوه به‌تأیید رساندن
اگر همه شرایط زیر برقرار باشد، این مشکل بر شما تأثیر می‌گذارد:
- یک توکن توسعه‌دهنده با سطح دسترسی «آزمایشی» دارید.
- قبل‌از ۹ سپتامبر ۲۰۲۶، از پروژه Google Cloud و کد توسعه‌دهنده خود برای فراخوانی Google Ads API استفاده کرده‌اید.
- سطح دسترسی پروژه Google Cloud خود را پس‌از ۹ سپتامبر ۲۰۲۶ به دسترسی «کاوشگر»، «پایه»، یا «استاندارد» ارتقا داده‌اید.
- فراخوانی‌های میانای برنامه‌سازی کاربردی شما به حساب تولید با
AUTHORIZATION_ERRORناموفق است. فراخوان‌های میانای برنامه‌سازی کاربردی به حساب‌های آزمایشی موفقیت‌آمیز است.
وضعیت
ما راه‌حلی برای این مشکل داریم و درحال کار روی عرضه آن به سرورهایمان هستیم. وقتی اصلاحیه فعال شود، فراخوان‌های میانای برنامه‌سازی کاربردی شما دوباره کار خواهند کرد.
راه‌حل موقت
می‌توانید از پروژه Google Cloud جدیدی برای درخواست دسترسی Explorer استفاده کنید.
پرسشگان
بخش زیر پاسخ پرسش‌های متداول درباره پایان کار کد توسعه‌دهنده و سطوح دسترسی به API را ارائه می‌دهد.
چه اتفاقی برای سطوح دسترسی به میانای برنامه‌سازی کاربردی می‌افتد؟
سطوح دسترسی میانای برنامه‌سازی کاربردی هنوز در Google Ads API اعمال می‌شود. بااین‌حال، این محدودیت‌ها به‌جای کد توسعه‌دهنده شما، به پروژه «کنسول Google Cloud» شما اعطا می‌شود. وقتی فراخوانی میانای برنامه‌سازی کاربردی انجام می‌دهید، سطوح دسترسی میانای برنامه‌سازی کاربردی شما توسط پروژه Google Cloud که برای تولید اعتبارنامه‌های OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه‌تان از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این پروژه‌ای است که شناسه و رمز کارخواه OAuth شما را دارد.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این همان پروژه‌ای است که حساب خدمات شما را دراختیار دارد.
پروژه‌ها چگونه برای انتقال سطوح دسترسی به میانای برنامه‌سازی کاربردی شناسایی شدند؟
اگر پیش‌از ۹ سپتامبر ۲۰۲۶، ازقبل یک کد توسعه‌دهنده تأییدشده داشتید، سطوح دسترسی آن به‌صورت زیر به پروژه‌های Google Cloud شما منتقل شده است:
- گزارش‌های تماس API را برای ۹۰ روز گذشته بررسی کردیم تا مشخص کنیم کدام پروژه‌های Cloud برای برقراری تماس‌های API با کد توسعه‌دهنده تأییدشده شما استفاده شده‌اند.
- سطوح دسترسی 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بیش‌از ۹۰ روز پیش با این کد توسعه‌دهنده استفاده شده است. - پروژه ابری: شناسه پروژه ابری:
7171234567هرگز با هیچ‌کدام از کدهای توسعه‌دهنده برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نشده است.
سطوح دسترسی میانای برنامه‌سازی کاربردی از کدهای توسعه‌دهنده به پروژه‌های Google Cloud به‌صورت زیر منتقل می‌شود:
| کد توسعه‌دهنده | شناسه پروژه | سطح دسترسی | توضیح |
|---|---|---|---|
abcdefghijkl1234567890 |
1234567890 |
دسترسی استاندارد | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 |
5678912345 |
دسترسی استاندارد | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 |
45678912345 |
دسترسی استاندارد | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
xyzabcdefghi6789012345 |
1231235678 |
دسترسی پایه | کد توسعه‌دهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
asdfgflkjhjz7654321012 |
-- |
-- |
دسترسی میانای برنامه‌سازی کاربردی کد توسعه‌دهنده به هیچ پروژه‌ای منتقل نشد چون هرگز برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نشده بود. |
qwertypoiuyu6543298790 |
9876564900 |
دسترسی آزمایشی | دسترسی میانای برنامه‌سازی کاربردی به کد توسعه‌دهنده به‌دلیل عدم فعالیت به‌مدت ۹۰ روز لغو شد. سطح دسترسی میانای برنامه‌سازی کاربردی پروژه به‌طور پیش‌فرض روی دسترسی «آزمایشی» تنظیم شده است. |
-- |
7171234567 |
دسترسی آزمایشی | این پروژه جدیدی است که با هیچ‌کدام از نشان‌های توسعه‌دهنده استفاده نشده است. سطح دسترسی API پروژه به‌طور پیش‌فرض روی «دسترسی آزمایشی» تنظیم شده است. |
بیش‌از یک کد توسعه‌دهنده تأییدشده دارم. سطوح دسترسی میانای برنامه‌سازی کاربردی را به کدام پروژه منتقل خواهید کرد؟
سطوح دسترسی هر کد توسعه‌دهنده تأییدشده به پروژه‌های Google Cloud مرتبط با آن کد توسعه‌دهنده منتقل می‌شود. نمونه‌ای را ببینید.
از چند پروژه Google Cloud استفاده می‌کنم. سطوح دسترسی API را به کدام پروژه منتقل خواهید کرد؟
اگر در ۹۰ روز گذشته از چند پروژه Google Cloud با کد توسعه‌دهنده تأییدشده‌تان استفاده کرده‌اید، همه آن پروژه‌ها همان سطوح دسترسی به API کد توسعه‌دهنده‌تان را دریافت خواهند کرد. نمونه را ببینید.
سطوح دسترسی API به پروژه‌ای اختصاص داده شده است که دیگر از آن استفاده نمی‌کنم. چگونه این مشکل را برطرف کنم؟
اگر دسترسی به Google Ads API به پروژه Google Cloud اختصاص داده شده است که دیگر از آن استفاده نمی‌کنید، اقدام دیگری ازجانب شما لازم نیست. Google پس‌از ۹۰ روز عدم فعالیت، دسترسی به API را برای پروژه استفاده‌نشده لغو خواهد کرد.
سطوح دسترسی API به پروژه Google Cloud من اختصاص داده نشده است. چگونه این مشکل را برطرف کنم؟
پروژه Google Cloud شما سطح دسترسی کد توسعه‌دهنده‌تان را به ارث نبرده است، احتمالاً به این دلیل که هرگز از کد توسعه‌دهنده و پروژه Cloud برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نکرده‌اید، یا دسترسی میانای برنامه‌سازی کاربردی کد توسعه‌دهنده‌تان به‌دلیل غیرفعال بودن منقضی شده است. برای رفع مشکل، برای سطح دسترسی API مناسب برای آن پروژه از صفحه نمای کلی Google Ads 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 Cloud خود درخواست دهید.
یک کد توسعه‌دهنده تأییدشده دارم، اما هرگز از آن استفاده نکرده‌ام. آیا می‌توانم از این کد توسعه‌دهنده استفاده کنم؟
نه، نمی‌توانید از این توکن توسعه‌دهنده استفاده کنید. دو احتمال وجود دارد:
ممکن است دسترسی به کد توسعه‌دهنده شما به‌دلیل عدم فعالیت لغو شود: طبق خط‌مشی‌های Google، اگر کد API شما به‌مدت ۹۰ روز متوالی استفاده نشود، Google ممکن است آن را لغو کند. اگر مدتی است از کد توسعه‌دهنده خود استفاده نکرده‌اید، احتمالاً سطح دسترسی آن به‌دلیل عدم فعالیت لغو شده است. اگر این‌طور است، دوباره برای دسترسی به میانای برنامه‌سازی کاربردی برای پروژه Google Cloud خود از صفحه نمای کلی Google Ads API درخواست دهید. نمونه را ببینید.
کد توسعه‌دهنده شما ظرف ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده است، اما هرگز از آن استفاده نکرده‌اید: چون هرگز از کد توسعه‌دهنده تأییدشده‌تان با پروژه Cloud قبل‌از ۹ سپتامبر ۲۰۲۶ استفاده نکرده‌اید، سطوح دسترسی آن به پروژه Cloud منتقل نشده است. درنتیجه، دیگر نمی‌توانید از کد توسعه‌دهنده خود استفاده کنید. اگر بخواهید با این ژتون توسعه‌دهنده، فراخوانی میانای برنامه‌سازی کاربردی به حساب تولید انجام دهید، خطای
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONرا نشان خواهیم داد. برای برطرف کردن این خطا، از صفحه نمای کلی Google Ads API در پروژه Google Cloud خود برای دسترسی مناسب به میانای برنامه‌سازی کاربردی درخواست دهید. نمونه‌ای را ببینید.
در هر دو مورد، می‌توانید برای دسترسی 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 Center موجود در حساب مدیر 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 خودتان ثبت‌نام نکنید؛ این درخواست‌ها پردازش نخواهند شد. «مرکز میانای برنامه‌سازی کاربردی» در آینده نزدیک برچیده خواهد شد.
برای مدیریت سطوح دسترسی API، چه اجازه‌های IAM لازم است؟
برای مدیریت سطوح دسترسی Google Ads API، به اجازه‌های مدیریت سهمیه برای پروژه Google Cloud خود نیاز دارید. اجازه‌های لازم به‌طور پیش‌فرض برای نقش‌های زیر لحاظ شده است: «مالک»، «ویرایشگر»، «سرپرست سهمیه»، و «سرپرست استفاده از سرویس». برای اطلاعات بیشتر، مستندات اجازه‌های سهمیه را ببینید.
می‌توانید صفحه IAM را برای پروژه Google Cloud خود بررسی کنید تا نقش‌های اختصاص‌داده‌شده به خود را ببینید. با سرپرست پروژه Google Cloud خود همکاری کنید تا نقش‌های IAM لازم را برای پروژه Google Cloud شما اعطا کند.