کد توسعه‌دهنده رشته‌ای الفباعددی ۲۲ نویسه‌ای است که برای متصل کردن برنامه شما به Google Ads API استفاده می‌شود. توکن‌های توسعه‌دهنده در ۹ سپتامبر ۲۰۲۶ منسوخ شدند. این راهنما تغییرات را خلاصه می‌کند و پرسش‌های متداول درباره این انتقال را فهرست می‌کند تا به توسعه‌دهندگان فعلی کمک کند.
چه چیزی تغییر می‌کند؟
ما چندین تغییر در تجربه آماده‌سازی Google Ads API و مدیریت دسترسی API به‌عنوان بخشی از پایان کار کد توسعه‌دهنده معرفی کردیم. این بخش تغییرات کلیدی را برجسته می‌کند.
سطوح دسترسی به میانای برنامه‌سازی کاربردی با پروژه‌های Google Cloud مرتبط است
در تاریخ ۹ سپتامبر ۲۰۲۶، توکن‌های توسعه‌دهنده را منسوخ می‌کنیم. سطح دسترسی فعلی و فعال رمز توسعه‌دهنده شما براساس فعالیت API در ۹۰ روز قبل‌از پایان پشتیبانی، به‌طور خودکار به پروژه‌های Google Cloud شما منتقل شد. می‌توانید ارسال کد توسعه‌دهنده را در سرایندهای تماس با میانای برنامه‌سازی کاربردی ادامه دهید، اما این کار اختیاری است و سرورهای میانای برنامه‌سازی کاربردی آن را نادیده می‌گیرند. کد موجود شما بدون هیچ تغییری به کار خود ادامه خواهد داد. سطوح دسترسی به میانای برنامه‌سازی کاربردی شما براساس پروژه Google Cloud که برای تولید اطلاعات اعتباری OAuth استفاده کرده‌اید تعیین می‌شود.
- اگر برنامه شما از گردش کار اصالت‌سنجی کاربر استفاده می‌کند، این پروژه پروژه‌ای است که مالک شناسه و رمز کارخواه OAuth شما است.
- اگر از گردش کار حساب خدمات استفاده می‌کنید، این پروژه مالک حساب خدمات شما است.
تجربه ثبت‌نام جدید برای «میانای برنامه‌سازی کاربردی Google Ads»
می‌توانید مستقیماً در «کنسول Google Cloud» برای دسترسی به Google Ads API ثبت‌نام کنید و به حساب مدیر Google Ads نیاز نداشته باشید. از صفحه «مرکز API» برای دریافت کد توسعه‌دهنده ثبت‌نام نکنید یا از صفحه «مرکز API» در حساب مدیر Google Ads خود برای دسترسی به API درخواست نکنید، زیرا این فرایندها به «کنسول Google Cloud» منتقل شده‌اند و اگر از صفحه «مرکز API» شروع شوند، پردازش نخواهند شد.
تجربه جدید مدیریت دسترسی به API
همه عملکردهای جدید ثبت‌نام و مدیریت دسترسی به «میانای برنامه‌سازی کاربردی» مانند درخواست دسترسی به «میانای برنامه‌سازی کاربردی» و مدیریت سطوح دسترسی به «میانای برنامه‌سازی کاربردی» در صفحه «مرکز میانای برنامه‌سازی کاربردی» در حساب‌های مدیر Google Ads را متوقف کرده‌ایم. این عملکردها درعوض در صفحه «نمای کلی Google Ads API» در Google Cloud Console دردسترس است.
همچنان می‌توانید به صفحه «مرکز API» دسترسی داشته باشید تا به جزئیات توسعه‌دهنده تاریخی خود مراجعه کنید. این صفحه در آینده به‌طور کامل برچیده خواهد شد.
کدهای خطای جدید
اگر بخواهید از پروژه Google Cloud با
دسترسی «آزمایشی» برای برقراری تماس با حساب تولید استفاده کنید، نسخه v25 از Google Ads API خطای
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
ایجاد می‌کند. نسخه‌های قدیمی‌تر
API به‌جای آن خطای
AuthorizationError.ACTION_NOT_PERMITTED ارائه خواهند داد. اگر با این خطا مواجه شدید، به
صفحه «نمای کلی میانای برنامه‌سازی کاربردی Google Ads» برای پروژه Google Cloud خود بروید
و برای دسترسی به «کاوشگر» درخواست دهید.
درستی‌سنجی نمانام برای دسترسی «پایه» و «استاندارد» الزامی است
برای برنامه‌های دسترسی «پایه» و «استاندارد» جدید، باید درستی‌سنجی نمانام را برای پروژه 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»، شروع به ارسال «اعلان‌های خدمات اجباری» (MSAs) به این نشانی‌های ایمیل خواهیم کرد. برای یک دوره موقت، همچنان «قراردادهای خدمات اصلی» را به نشانی ایمیل مخاطب فهرست‌شده در مرکز API شما ارسال خواهیم کرد و هر زمان این فرایند به‌روزرسانی شود به شما اطلاع خواهیم داد.
کد برنامه‌تان را اصلاح کنید: توصیه می‌کنیم برنامه‌تان را به‌روز کنید تا ارسال کد توسعه‌دهنده به‌عنوان بخشی از تماس‌های 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 خود را پس‌از ۹ سپتامبر ۲۰۲۶ به «کاوشگر»، «دسترسی پایه»، یا «دسترسی استاندارد» ارتقا داده باشید.
- فراخوانی‌های API شما به حساب تولید با
AUTHORIZATION_ERRORناموفق است. فراخوان‌های API به حساب‌های آزمایشی موفقیت‌آمیز است.
وضعیت
راه‌حلی برای این مشکل داریم و درحال کار روی ارائه آن به سرورهای خود هستیم. پس‌از اینکه اصلاح فعال شد، فراخوان‌های «میانای برنامه‌سازی کاربردی» شما دوباره شروع به کار خواهند کرد.
راهکار موقت
می‌توانید از پروژه Google Cloud جدیدی برای درخواست دسترسی «کاوشگر» استفاده کنید.
پرسشگان
چه اتفاقی برای سطوح دسترسی API می‌افتد؟
سطوح دسترسی «میانای برنامه‌سازی کاربردی» همچنان در «میانای برنامه‌سازی کاربردی Google Ads» اعمال می‌شود. بااین‌حال، این مجوزها به‌جای توکن توسعه‌دهنده به پروژه «کنسول 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دسترسی «پایه» دارد، اما هرگز برای برقراری تماس با «میانای برنامه‌سازی کاربردی» استفاده نشده است. این مجوز ظرف ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده باشد. - Developer Token 4:
qwertypoiuyu6543298790دسترسی «استاندارد» داشت، اما در ۹۰ روز گذشته از آن استفاده نشده است. شناسه پروژه9876564900بیش‌از ۹۰ روز پیش با این رمز توسعه‌دهنده استفاده شده است. - پروژه ابری: شناسه پروژه ابری:
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 را برای پروژه استفاده‌نشده لغو خواهد کرد.
سطوح دسترسی API به پروژه Google Cloud من اختصاص داده نشده است. چگونه این مشکل را برطرف کنم؟
پروژه Google Cloud شما سطح دسترسی کد توسعه‌دهنده‌تان را به ارث نبرده است، احتمالاً به این دلیل که هرگز از کد توسعه‌دهنده و پروژه Cloud برای فراخوانی میانای برنامه‌سازی کاربردی استفاده نکرده‌اید، یا دسترسی میانای برنامه‌سازی کاربردی کد توسعه‌دهنده‌تان به‌دلیل عدم فعالیت منقضی شده است. برای رفع این مشکل، از صفحه نمای کلی Google Ads API برای آن پروژه درخواست سطح دسترسی API مناسب کنید. مثالی ببینید.
کجا می‌توانم سطوح دسترسی API پروژه‌ام را ببینم؟
می‌توانید سطح دسترسی API پروژه Google Cloud خود را در صفحه «نمای کلی Google Ads API» ببینید.
چگونه برای سطوح دسترسی بالاتر به API درخواست دهم؟
می‌توانید از صفحه «نمای کلی Google Ads API» برای پروژه Google Cloud خود درخواست سطوح دسترسی API بالاتر بدهید.
چه اتفاقی برای درخواست دسترسی به API معلقه من می‌افتد؟
هرگونه درخواست معلقه «دسترسی پایه» که قبل‌از ۹ سپتامبر ۲۰۲۶ از «مرکز API» حساب مدیر Google Ads خود آغاز کرده‌اید بسته خواهد شد. باید از صفحه «نمای کلی Google Ads API» پروژه Google Cloud خود دوباره برای دسترسی «پایه» درخواست دهید. اگر تحت تأثیر این تغییر قرار بگیرید، ایمیلی حاوی دستورالعمل‌های لازم دریافت خواهید کرد.
هرگونه درخواست دسترسی «استاندارد» معلقه که از «مرکز API» حساب مدیر Google Ads خود از تاریخ ۹ سپتامبر ۲۰۲۶ آغاز کرده‌اید، طبق معمول بررسی خواهد شد. درصورت تأیید، پروژه Google Cloud مرتبط با رمز توسعه‌دهنده شما دسترسی «استاندارد» دریافت خواهد کرد.
آیا می‌توانم کد توسعه‌دهنده تأییدشده‌ام را با پروژه Google Cloud جدیدی دوباره مرتبط کنم؟
قبل‌از ۹ سپتامبر ۲۰۲۶، تیم Google Ads API از مرتبط کردن مجدد یک کد توسعه‌دهنده با یک پروژه جدید Google Cloud به‌صورت موردی پشتیبانی می‌کرد. این از ۹ سپتامبر ۲۰۲۶ دیگر پشتیبانی نمی‌شود، زیرا ما توکن‌های توسعه‌دهنده را منسوخ کرده‌ایم. اگر نیاز به استفاده از پروژه Google Cloud جدیدی دارید، باید از صفحه نمای کلی Google Ads API پروژه Google Cloud خود برای دسترسی به میانای برنامه‌سازی کاربردی مناسب درخواست دهید.
یک کد توسعه‌دهنده تأییدشده دارم، اما هرگز از آن استفاده نکرده‌ام. آیا می‌توانم از این کد توسعه‌دهنده استفاده کنم؟
نه، نمی‌توانید از این کد توسعه‌دهنده استفاده کنید. دو احتمال وجود دارد:
دسترسی به کد توسعه‌دهنده شما ممکن است به‌دلیل عدم فعالیت لغو شود: طبق خط‌مشی‌های Google، اگر از کد API شما به‌طور متوالی به‌مدت ۹۰ روز استفاده نشود، Google ممکن است آن را لغو کند. اگر مدتی است از کد توسعه‌دهنده خود استفاده نکرده‌اید، احتمالاً سطوح دسترسی آن به‌دلیل عدم فعالیت لغو شده است. اگر این‌طور است، از صفحه نمای کلی میانای برنامه‌سازی کاربردی Google Ads، دوباره برای دسترسی به میانای برنامه‌سازی کاربردی برای پروژه Google Cloud خود درخواست دهید. مثالی ببینید.
نمانام توسعه‌دهنده شما در ۹۰ روز قبل‌از ۹ سپتامبر ۲۰۲۶ تأیید شده است، اما هرگز از آن استفاده نکرده‌اید: ازآنجایی‌که هرگز از نمانام توسعه‌دهنده تأییدشده‌تان با پروژه Google Cloud قبل‌از ۹ سپتامبر ۲۰۲۶ استفاده نکرده‌اید، سطوح دسترسی آن به پروژه Cloud منتقل نشده است. درنتیجه، دیگر نمی‌توانید از رمز توسعه‌دهنده خود استفاده کنید. اگر با این کد توسعه‌دهنده سعی کنید برای حساب تولید فراخوانی میانای برنامه‌سازی کاربردی انجام دهید، خطای
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONدریافت خواهید کرد. برای رفع این خطا، از صفحه «نمای کلی Google Ads API» پروژه Google Cloud خود برای دسترسی به میانای برنامه‌سازی کاربردی مناسب درخواست دهید. مثالی ببینید.
در هر دو این موارد، می‌توانید برای دسترسی «کاوشگر» و سطح دسترسی «پایه» درخواست دهید و درخواست‌هایتان به‌طور خودکار بررسی شود؛ دیگر لازم نیست برای تکمیل فرایند بررسی با «تیم رعایت استانداردها» در Google همکاری کنید. اگر به دسترسی استاندارد نیاز دارید، باید بازبینی دستی انجام دهید. بااین‌حال، هنگام درخواست برای دسترسی «استاندارد»، می‌توانید جزئیات کد توسعه‌دهنده تأییدشده خود را هم‌رسانی کنید تا «تیم رعایت استانداردها» بتواند درخواست دسترسی «استاندارد» جدید شما را براساس آن بررسی کند.
آیا می‌توانم ارسال کدهای توسعه‌دهنده را به‌عنوان بخشی از درخواست‌های API متوقف کنم؟
بله، می‌توانید ارسال کدهای توسعه‌دهنده را به‌عنوان بخشی از درخواست‌های API متوقف کنید. اگر از کتابخانه کارخواه استفاده می‌کنید، ممکن است لازم باشد به جدیدترین نسخه آن ارتقا دهید. گزارش‌های تغییر کتابخانه را بررسی کنید تا مطمئن شوید که از ایجاد تماس‌های API بدون مشخص کردن کد توسعه‌دهنده پشتیبانی می‌کند.
من بخشی از برنامه آزمایشی سطح دسترسی مدیریت‌شده با Cloud بودم. چگونه تحت تأثیر قرار می‌گیرم؟
برنامه آزمایشی سطح دسترسی مدیریت‌شده با Cloud به‌عنوان روشی برای توسعه‌دهندگان Google Cloud معرفی شد تا بتوانند بدون ارسال کد توسعه‌دهنده به‌عنوان بخشی از درخواست 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» می‌افتد؟
صفحه «مرکز API» موجود در حساب مدیر Google Ads منسوخ شده است و در آینده نزدیک برداشته خواهد شد. اگر ازقبل کد توسعه‌دهنده دارید، همچنان می‌توانید به سیستم حساب مدیر Google Ads خود وارد شوید و جزئیات را مشاهده کنید. بااین‌حال، این‌ها فقط برای مرجع شما ارائه شده‌اند. از این صفحه هیچ کاری مربوط به سطوح دسترسی کد توسعه‌دهنده انجام ندهید، مثلاً برای سطوح دسترسی بالاتر میانای برنامه‌سازی کاربردی درخواست ندهید.
اگر نیاز دارید برای سطوح دسترسی بالاتر به «میانای برنامه‌سازی کاربردی» درخواست دهید، باید این کار را از صفحه «نمای کلی میانای برنامه‌سازی کاربردی Google Ads» پروژه Google Cloud خود انجام دهید.
آیا برای استفاده از Google Ads API همچنان به حساب مدیر Google Ads نیاز دارم؟
دیگر برای استفاده از «میانای برنامه‌سازی کاربردی Google Ads» به حساب مدیر Google Ads نیاز ندارید. فقط درصورتی به حساب مدیر نیاز دارید که بخواهید بااستفاده از API به چند حساب پیوند دهید و آن‌ها را مدیریت کنید.
توسعه‌دهنده جدید هستم. چگونه برای Google Ads API ثبت‌نام کنم؟
برای ثبت‌نام در Google Ads API، دستورالعمل‌های راهنمای شروع به کار را دنبال کنید. از «مرکز API» حساب مدیر Google Ads خود برای دریافت کد توسعه‌دهنده ثبت‌نام نکنید؛ این برنامه‌ها پردازش نخواهند شد. «مرکز API» در آینده نزدیک برچیده خواهد شد.
برای مدیریت سطوح دسترسی API، چه اجازه‌های IAM لازم است؟
برای مدیریت سطوح دسترسی Google Ads API، باید اجازه‌های مدیریت سهمیه برای پروژه Google Cloud خود داشته باشید. اجازه‌های لازم به‌طور پیش‌فرض برای نقش‌های زیر درنظر گرفته شده است: مالک، ویرایشگر، سرپرست سهمیه، و سرپرست استفاده از سرویس. برای اطلاعات بیشتر، مستندات اجازه‌های سهمیه را ببینید.
برای دیدن نقش‌های اختصاص‌یافته، می‌توانید صفحه IAM را برای پروژه Google Cloud خود بررسی کنید. با سرپرست پروژه Google Cloud خود همکاری کنید تا نقش‌های IAM لازم را برای پروژه Google Cloud خود اعطا کنید.