توکن توسعهدهنده یک رشته الفبایی-عددی ۲۲ کاراکتری است که برای اتصال برنامه شما به API تبلیغات گوگل استفاده میشد. توکنهای توسعهدهنده در ۹ سپتامبر ۲۰۲۶ غیرفعال شدند. این راهنما تغییرات را خلاصه کرده و سوالات متداول در مورد این انتقال را برای کمک به توسعهدهندگان فعلی فهرست میکند.
چه چیزی در حال تغییر است؟
ما به عنوان بخشی از پایان مهلت استفاده از توکن توسعهدهندگان، چندین تغییر در تجربه کاربری و مدیریت دسترسی API گوگل ادز اعمال کردیم. این بخش به تغییرات کلیدی میپردازد.
سطوح دسترسی API با پروژههای Google Cloud مرتبط هستند
ما در تاریخ ۹ سپتامبر ۲۰۲۶ توکنهای توسعهدهنده را غیرفعال میکنیم. سطح دسترسی توکن توسعهدهنده فعلی و فعال شما بر اساس فعالیت اخیر API به طور خودکار به پروژههای Google Cloud شما منتقل شده است. میتوانید به ارسال توکنهای توسعهدهنده در هدرهای فراخوانی API خود ادامه دهید، اما این اختیاری است و توسط سرورهای API نادیده گرفته میشود. کد موجود شما بدون هیچ تغییری به کار خود ادامه خواهد داد. سطوح دسترسی API شما اکنون توسط پروژه Google Cloud که برای تولید اعتبارنامههای OAuth خود استفاده کردهاید، تعیین میشود.
- اگر برنامه شما از گردش کار احراز هویت کاربر استفاده میکند، این پروژهای است که شناسه و رمز کلاینت OAuth شما را در اختیار دارد.
- اگر از گردش کار حساب سرویس استفاده میکنید، این پروژهای است که صاحب حساب سرویس شماست.
یک تجربه ثبت نام جدید برای API تبلیغات گوگل
اکنون میتوانید بدون نیاز به حساب مدیریت تبلیغات گوگل، مستقیماً در کنسول ابری گوگل برای دسترسی به API تبلیغات گوگل ثبتنام کنید . از صفحه مرکز API برای دریافت توکن توسعهدهنده ثبتنام نکنید و سعی نکنید از صفحه مرکز API در حساب مدیریت تبلیغات گوگل خود برای دسترسی به API درخواست دهید، زیرا این فرآیندها به کنسول ابری گوگل منتقل شدهاند و در صورت شروع از صفحه مرکز API، پردازش نخواهند شد.
یک تجربه جدید مدیریت دسترسی API
ما تمام قابلیتهای جدید ثبت نام و مدیریت دسترسی به API، مانند درخواست دسترسی به API و مدیریت سطوح دسترسی API را در صفحه مرکز API در حسابهای مدیریت تبلیغات گوگل (Google Ads manager) حذف کردهایم. این قابلیتها اکنون در صفحه نمای کلی API تبلیغات گوگل (Google Ads API Overview) در کنسول ابری گوگل (Google Cloud Console) در دسترس هستند.
شما هنوز میتوانید به صفحه مرکز API دسترسی داشته باشید تا به جزئیات توسعهدهندگان قبلی خود مراجعه کنید. این صفحه در آینده کاملاً غیرفعال خواهد شد.
کدهای خطای جدید
اگر سعی کنید از یک پروژه Google Cloud با دسترسی Test برای برقراری تماس با یک حساب کاربری در حال تولید استفاده کنید، نسخه v25 از API تبلیغات گوگل، خطای CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION را نشان میدهد. نسخههای قدیمیتر API به جای آن، خطای ACTION_NOT_PERMITTED را نشان میدهند. اگر با این خطا مواجه شدید، به صفحه نمای کلی API تبلیغات گوگل برای پروژه Google Cloud خود بروید و برای دسترسی به Explorer درخواست دهید .
تأیید برند برای دسترسی پایه و استاندارد الزامی است
برای برنامههای جدید دسترسی پایه و استاندارد، باید تأیید برند را برای پروژه Google Cloud خود تکمیل کنید. دارندگان دسترسی فعلی ملزم به تکمیل تأیید برند نیستند، هرچند که این کار توصیه میشود.
درخواستهای دسترسی اولیه اکنون خودکار شدهاند و پس از تأیید و ارسال برند، ظرف چند دقیقه بررسی خواهند شد.
با توجه به این بهروزرسانیهای فرآیند، تمام درخواستهای دسترسی پایه که در انتظار دریافت بودند، به عنوان بخشی از این انتقال بسته خواهند شد. متقاضیان تحت تأثیر، ایمیلی حاوی جزئیات دریافت خواهند کرد و باید دوباره برای دسترسی پایه از صفحه نمای کلی API تبلیغات گوگل درخواست دهند.
ایمیلهای تماس جدید API
همزمان با آماده شدن برای غیرفعال کردن صفحه مرکز API ، به استفاده از فهرست کاربران مالک و ویرایشگر در پروژه Google Cloud شما به عنوان تنها کانال برای ارتباطات اداری و انطباق اجباری روی خواهیم آورد. برای اطمینان از یک انتقال روان، ما به طور موقت به ارسال اطلاعیههای خدمات اجباری (MSA) به آدرس ایمیل ذکر شده در مرکز API شما ادامه خواهیم داد. با نهایی شدن انتقال کانالهای ارتباطی، شما را در جریان خواهیم گذاشت.
اگر یک توسعهدهندهی فعلی هستید، چه باید بکنید؟
سطوح دسترسی API پروژه Google Cloud خود را بررسی کنید: اگر شما یک توسعهدهنده موجود هستید، از شما میخواهیم که صفحه نمای کلی API تبلیغات گوگل پروژههای Google Cloud خود را بررسی کنید تا مطمئن شوید که سطح دسترسی API آنها با توکن توسعهدهنده موجود شما یکسان است. برای رفع هرگونه اختلافی که ممکن است پیدا کنید، دستورالعملهای این راهنما را دنبال کنید.
آدرس ایمیل تماس با API خود را بررسی کنید: به صفحه IAM (مدیریت هویت و دسترسی) برای پروژه Google Cloud خود مراجعه کنید. تأیید کنید که به توسعهدهندگان فعال تبلیغات و مدیران حساب شما ، نقشهای مالک یا ویرایشگر مناسبی در پروژه Google Cloud شما اختصاص داده شده است. ما ارسال اطلاعیههای خدمات اجباری (MSA) را به این آدرسهای ایمیل آغاز خواهیم کرد تا شما را از هرگونه تغییر آینده در API تبلیغات Google مطلع کنیم. ما به طور موقت ارسال MSA به آدرس ایمیل تماس ذکر شده در مرکز API شما را ادامه خواهیم داد و هر زمان که این فرآیند بهروزرسانی شود، به شما اطلاع خواهیم داد.
اصلاح کد برنامه: ما شما را تشویق میکنیم که برنامه خود را بهروزرسانی کنید تا ارسال توکن توسعهدهنده به عنوان بخشی از فراخوانیهای API متوقف شود. ما نسخههای بهروز شدهای از کتابخانههای کلاینت ، سرور Google Ads MCP و دستیار توسعهدهنده API Google Ads را منتشر کردهایم که به شما امکان میدهد بدون تنظیم توکن توسعهدهنده، فراخوانیهای API را انجام دهید. ما در نسخه اصلی آینده API Google Ads، رد توکنهای توسعهدهنده در فراخوانیهای API را آغاز خواهیم کرد. اگر برنامه شما از این کتابخانهها استفاده میکند، وابستگیهای برنامه را بهروزرسانی کنید تا از آخرین نسخه استفاده کنند.
اگر به کمک بیشتری نیاز دارید یا سوالات بیشتری دارید، با پشتیبانی Google Ads API تماس بگیرید.
مشکلات شناخته شده
این بخش تمام مسائل شناختهشده مربوط به پایان عمر توکنهای توسعهدهندگان را مستند میکند.
حتی پس از تکمیل تأیید برند، به کاربران دسترسی اکسپلورر یا دسترسی پایه داده نمیشود.
ما از مشکلی آگاه هستیم که برخی از کاربران با پروژههای دارای برند تأیید شده، هنگام درخواست برای دسترسی پایه، رد میشوند. کاربران یک ایمیل رد دریافت میکنند که میگوید: «دسترسی پایه نیاز به یک پروفایل برند OAuth با موفقیت تأیید شده دارد. درخواست شما نمیتواند تأیید شود زیرا شما تأیید برند را برای پروژه خود تکمیل نکردهاید.» به طور مشابه، برخی از کاربرانی که برای دسترسی به Explorer ثبتنام میکنند نیز با یک ایمیل رد مواجه میشوند که میگوید: «در حال حاضر، ما نمیتوانیم به پروژه Google Cloud شما دسترسی Explorer بدهیم زیرا معیارهای واجد شرایط بودن مورد نیاز برای دسترسی مستقیم به حساب تولید تحت سیاستها و شرایط خدمات API تبلیغات گوگل ما را برآورده نمیکند.»
علت ریشهای
پروژه گوگل کلود شما ممکن است در برنامه آزمایشی رایگان گوگل کلود باشد یا حساب صورتحساب آن معلق یا غیرفعال باشد.
نحوه تأیید
وضعیت صورتحساب Google Cloud خود را بررسی کنید. اگر پروژه صورتحساب شما به صورت «حساب آزمایشی رایگان» نمایش داده میشود یا در حالت تعلیق یا غیرفعال است، شما تحت تأثیر این مشکل قرار دارید.
وضعیت
ما علت اصلی را شناسایی کردهایم و در حال کار بر روی رفع این مشکل هستیم.
راه حل موقت
چندین راه حل برای حل این مشکل وجود دارد. مناسب ترین گزینه را برای مورد استفاده خود انتخاب کنید.
پروژه Google Cloud خود را به یک سطح پولی ارتقا دهید
پروژه گوگل کلود خود را به سطح پولی ارتقا دهید. چند دقیقه صبر کنید و دوباره برای دسترسی پایه درخواست دهید.
حذف صورتحساب برای پروژه Google Cloud شما
اگر سرویسهای دیگری در پروژه Google Cloud شما در حال اجرا نیستند، پرداخت هزینه برای پروژه Google Cloud خود را حذف کنید . چند دقیقه صبر کنید و دوباره برای دسترسی پایه درخواست دهید.
از یک پروژه Google Cloud متفاوت استفاده کنید
اگر پروژه Google Cloud دیگری دارید که برند آن تأیید شده است، از آن پروژه برای درخواست دسترسی پایه استفاده کنید.
پروژههایی که سطوح دسترسی Basic یا Explorer آنها به تازگی تأیید شده است، خطای AUTHORIZATION_ERROR دریافت میکنند.
ما از مشکلی آگاه هستیم که برخی از کاربرانی که اخیراً سطح دسترسی پروژه Google Cloud خود را به سطوح دسترسی Basic یا Explorer تأیید شده ارتقا دادهاند، هنگام برقراری تماسهای API Google Ads با حسابهای کاربری فعال، خطای AUTHORIZATION_ERROR دریافت میکنند.
علت ریشهای
رابط برنامهنویسی کاربردی گوگل ادز (Google Ads API) از ارتقاء سطح دسترسی API که از طریق کنسول ابری گوگل برای برخی پروژهها تکمیل شده است، پشتیبانی نمیکند.
نحوه تأیید
اگر همه شرایط زیر صادق باشد، شما تحت تأثیر این مشکل قرار گرفتهاید:
- شما یک توکن توسعهدهنده با سطح دسترسی آزمایشی دارید.
- شما قبل از 9 سپتامبر 2026 از پروژه Google Cloud و توکن توسعهدهنده خود برای برقراری تماسهای API مربوط به Google Ads استفاده کردهاید.
- شما سطح دسترسی پروژه Google Cloud خود را بعد از ۹ سپتامبر ۲۰۲۶ به Explorer، Basic یا Standard ارتقا دادهاید.
- فراخوانیهای API شما به یک حساب کاربری فعال با خطای
AUTHORIZATION_ERRORبا شکست مواجه میشوند. فراخوانیهای API به حسابهای کاربری آزمایشی با موفقیت انجام میشوند.
وضعیت
ما برای این مشکل راهحلی داریم و در حال کار بر روی انتشار آن در سرورهای خود هستیم. به محض انتشار راهحل، فراخوانیهای API شما دوباره شروع به کار خواهند کرد.
راه حل موقت
شما میتوانید از یک پروژه جدید گوگل کلود برای درخواست دسترسی به اکسپلورر استفاده کنید.
سوالات متداول
چه اتفاقی برای سطوح دسترسی API میافتد؟
سطوح دسترسی API هنوز در API تبلیغات گوگل اعمال میشوند. با این حال، این سطوح اکنون به جای توکن توسعهدهنده شما، به پروژه کنسول گوگل کلود شما اعطا میشوند. هنگام برقراری تماسهای API، سطوح دسترسی API شما اکنون توسط پروژه گوگل کلود که برای تولید اعتبارنامههای OAuth خود استفاده کردهاید، تعیین میشود.
- اگر برنامه شما از گردش کار احراز هویت کاربر استفاده میکند، این پروژهای است که شناسه و رمز کلاینت OAuth شما را در اختیار دارد.
- اگر از گردش کار حساب سرویس استفاده میکنید، این پروژهای است که صاحب حساب سرویس شماست.
پروژهها برای انتقال سطوح دسترسی API چگونه شناسایی شدند؟
اگر قبل از ۹ سپتامبر ۲۰۲۶، توکن توسعهدهندهی تأیید شدهای داشتید، سطوح دسترسی آن به شرح زیر به پروژههای گوگل کلود شما منتقل شده است:
- ما گزارشهای فراخوانی API را برای ۹۰ روز گذشته بررسی کردیم تا مشخص کنیم کدام پروژههای ابری برای برقراری فراخوانیهای API با توکن توسعهدهندهی تأیید شدهی شما استفاده شدهاند.
- ما سطوح دسترسی API توکن توسعهدهنده را به تمام پروژههای ابری شناساییشده اختصاص دادیم.
آیا میتوانم بعد از این تغییر، چندین پروژه ابری با سطوح دسترسی مختلف داشته باشم؟
بله، شما میتوانید چندین پروژه گوگل کلود با سطوح دسترسی API مختلف داشته باشید. برای مثال، میتوانید یک پروژه گوگل کلود با دسترسی پایه و یک پروژه گوگل کلود دیگر با دسترسی استاندارد داشته باشید.
مثال
به عنوان مثال، فرض کنید که شما ۴ توکن توسعهدهنده و ۶ پروژه ابری با جزئیات زیر دارید:
- توکن توسعهدهنده ۱:
abcdefghijkl1234567890دارای دسترسی استاندارد است. این توکن با شناسههای پروژه1234567890،5678912345،45678912345استفاده شده است. - توکن توسعهدهنده ۲:
xyzabcdefghi6789012345دارای دسترسی پایه است. با شناسههای پروژه1231235678استفاده شده است. - توکن توسعهدهنده ۳:
asdfgflkjhjz7654321012دسترسی پایه دارد، اما هرگز برای فراخوانی API استفاده نشده است. این توکن اخیراً تأیید شده است. - توکن توسعهدهنده ۴:
qwertypoiuyu6543298790دسترسی استاندارد داشت، اما در ۹۰ روز گذشته استفاده نشده است. شناسه پروژه9876564900در گذشته با این توکن توسعهدهنده استفاده شده است. - پروژه ابری: شناسه پروژه ابری:
7171234567هرگز با هیچ یک از توکنهای توسعهدهنده برای فراخوانی API استفاده نشده است.
سطوح دسترسی API از توکنهای توسعهدهندگان به پروژههای Google Cloud به شرح زیر منتقل خواهد شد:
| توکن توسعهدهنده | شناسه پروژه | سطح دسترسی | توضیح |
|---|---|---|---|
abcdefghijkl1234567890 | 1234567890 | دسترسی استاندارد | توکن توسعهدهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 | 5678912345 | دسترسی استاندارد | توکن توسعهدهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
abcdefghijkl1234567890 | 45678912345 | دسترسی استاندارد | توکن توسعهدهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
xyzabcdefghi6789012345 | 1231235678 | دسترسی پایه | توکن توسعهدهنده و شناسه پروژه با یکدیگر مرتبط هستند. |
asdfgflkjhjz7654321012 | -- | -- | دسترسی API توکن توسعهدهنده به هیچ پروژهای منتقل نشده است، زیرا هرگز برای برقراری یک فراخوانی API استفاده نشده است. |
qwertypoiuyu6543298790 | 9876564900 | دسترسی آزمایشی | دسترسی API توکن توسعهدهنده به دلیل عدم فعالیت به مدت ۹۰ روز لغو شد. سطح دسترسی API پروژه به صورت پیشفرض روی دسترسی آزمایشی (Test access) است. |
-- | 7171234567 | دسترسی آزمایشی | این یک پروژه جدید است که با هیچ توکن توسعهدهندهای استفاده نشده است. سطح دسترسی API پروژه به صورت پیشفرض روی دسترسی آزمایشی (Test access) است. |
من بیش از یک توکن توسعهدهنده تأیید شده دارم. سطوح دسترسی API را به کدام پروژه منتقل خواهید کرد؟
سطوح دسترسی هر توکن توسعهدهندهی تأیید شده به پروژههای گوگل کلود مرتبط با آن توکن توسعهدهنده منتقل خواهد شد. به یک مثال توجه کنید.
من از چندین پروژه گوگل کلود استفاده میکنم. سطوح دسترسی API را به کدام پروژه منتقل خواهید کرد؟
اگر در ۹۰ روز گذشته از چندین پروژه Google Cloud با توکن توسعهدهنده تأیید شده خود استفاده کردهاید، تمام آن پروژهها همان سطوح دسترسی API توکن توسعهدهنده شما را دریافت خواهند کرد. به یک مثال توجه کنید.
سطوح دسترسی API به پروژهای اختصاص داده شده است که دیگر از آن استفاده نمیکنم. چگونه میتوانم این مشکل را برطرف کنم؟
اگر دسترسی به API گوگل ادز به یک پروژه گوگل کلود که دیگر از آن استفاده نمیکنید اختصاص داده شده باشد، هیچ اقدام اضافی از طرف شما لازم نیست. گوگل پس از ۹۰ روز عدم فعالیت، دسترسی API را برای پروژه استفاده نشده لغو خواهد کرد.
سطوح دسترسی API به پروژه Google Cloud من اختصاص داده نشده است. چگونه میتوانم این مشکل را برطرف کنم؟
پروژه Google Cloud شما سطح دسترسی توکن توسعهدهندهتان را به ارث نبرده است، احتمالاً به این دلیل که شما هرگز از توکن توسعهدهنده و پروژه Cloud برای برقراری تماس API استفاده نکردهاید، یا دسترسی API توکن توسعهدهنده شما اخیراً به دلیل عدم فعالیت منقضی شده است. برای رفع این مشکل، از صفحه نمای کلی API تبلیغات گوگل، برای سطح دسترسی API مناسب برای آن پروژه درخواست دهید. به یک مثال مراجعه کنید.
سطوح دسترسی API پروژهام را از کجا میتوانم ببینم؟
شما میتوانید سطح دسترسی API پروژه گوگل کلود خود را از صفحه مرور کلی API گوگل ادز مشاهده کنید.
چگونه میتوانم برای سطوح دسترسی بالاتر API درخواست دهم؟
شما میتوانید از صفحه بررسی اجمالی API تبلیغات گوگل، برای سطوح دسترسی بالاتر API برای پروژه Google Cloud خود درخواست دهید.
چه اتفاقی برای درخواست دسترسی API در انتظار من میافتد؟
هرگونه درخواست دسترسی پایه که قبل از ۹ سپتامبر ۲۰۲۶ از مرکز API حساب مدیریت تبلیغات گوگل خود آغاز کردهاید، بسته خواهد شد. شما باید دوباره برای دسترسی پایه از صفحه نمای کلی API تبلیغات گوگل پروژه گوگل کلود خود درخواست دهید. اگر این تغییر شامل حال شما میشود، ایمیلی حاوی دستورالعملهای لازم دریافت خواهید کرد.
هرگونه برنامه دسترسی استاندارد در انتظار که از تاریخ ۹ سپتامبر ۲۰۲۶ از مرکز API حساب مدیریت تبلیغات گوگل خود راهاندازی کردهاید، طبق معمول بررسی خواهد شد. در صورت تأیید، به پروژه گوگل کلود مرتبط با توکن توسعهدهنده شما دسترسی استاندارد اعطا خواهد شد.
آیا میتوانم توکن توسعهدهندهی تأیید شدهام را دوباره با یک پروژهی جدید گوگل کلود مرتبط کنم؟
در گذشته، تیم API تبلیغات گوگل از اتصال مجدد یک توکن توسعهدهنده با یک پروژه جدید گوگل کلود به صورت موردی پشتیبانی میکرد. این قابلیت از 9 سپتامبر 2026 دیگر پشتیبانی نمیشود، زیرا توکنهای توسعهدهنده از رده خارج شدهاند. اگر نیاز به استفاده از یک پروژه جدید گوگل کلود دارید، باید برای دسترسی به API مناسب از صفحه نمای کلی API تبلیغات گوگل پروژه گوگل کلود خود درخواست دهید.
من یک توکن توسعهدهنده تأیید شده دارم، اما هرگز از آن استفاده نکردهام. آیا میتوانم از این توکن توسعهدهنده استفاده کنم؟
خیر، شما نمیتوانید از این توکن توسعهدهنده استفاده کنید. دو احتمال وجود دارد:
ممکن است دسترسی به توکن توسعهدهنده شما به دلیل عدم فعالیت لغو شود: طبق سیاستهای گوگل ، اگر توکن API شما به مدت ۹۰ روز متوالی استفاده نشود، گوگل ممکن است آن را لغو کند. اگر مدتی است که از توکن توسعهدهنده خود استفاده نکردهاید، احتمالاً سطح دسترسی آن به دلیل عدم فعالیت لغو شده است. در این صورت، برای دسترسی به API برای پروژه Google Cloud خود از صفحه نمای کلی API تبلیغات گوگل (Google Ads API Overview) دوباره درخواست دهید. به یک مثال توجه کنید.
توکن توسعهدهنده شما اخیراً تأیید شده است، اما شما قبل از ۹ سپتامبر ۲۰۲۶ هرگز از آن استفاده نکردهاید: از آنجایی که شما قبل از ۹ سپتامبر ۲۰۲۶ هرگز از توکن توسعهدهنده تأیید شده خود با یک پروژه Google Cloud استفاده نکردهاید، سطوح دسترسی آن به پروژه Cloud منتقل نشده است. در نتیجه، دیگر نمیتوانید از توکن توسعهدهنده خود استفاده کنید. اگر سعی کنید با این توکن توسعهدهنده، یک فراخوانی API به یک حساب کاربری در حال تولید انجام دهید، خطای
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTIONرا نمایش خواهیم داد. برای رفع خطا، برای دسترسی API مناسب از صفحه نمای کلی API تبلیغات گوگل پروژه Google Cloud خود درخواست دهید. به یک مثال مراجعه کنید.
در هر دو مورد، میتوانید برای برنامههای دسترسی Explorer و سطح دسترسی Basic درخواست دهید و آنها را به طور خودکار بررسی کنید؛ دیگر نیازی به همکاری با تیم Compliance گوگل برای تکمیل فرآیند بررسی ندارید. اگر به دسترسی استاندارد نیاز دارید، به بررسی دستی نیاز دارید. با این حال، میتوانید جزئیات توکن توسعهدهنده تأیید شده خود را هنگام درخواست دسترسی استاندارد به اشتراک بگذارید تا تیم Compliance بتواند برنامه دسترسی استاندارد جدید شما را بر اساس آن بررسی کند.
آیا میتوانم ارسال توکنهای توسعهدهنده را به عنوان بخشی از درخواستهای API خود متوقف کنم؟
بله، میتوانید ارسال توکنهای توسعهدهنده را به عنوان بخشی از درخواستهای API خود متوقف کنید. اگر از یک کتابخانه کلاینت استفاده میکنید، ممکن است لازم باشد آن را به آخرین نسخه ارتقا دهید. گزارشهای تغییرات کتابخانه را بررسی کنید تا تأیید کنید که آیا از فراخوانی API بدون مشخص کردن توکن توسعهدهنده پشتیبانی میکند یا خیر.
من بخشی از برنامه آزمایشی سطح دسترسی مدیریتشده ابری بودم. چگونه تحت تأثیر قرار میگیرم؟
برنامه آزمایشی سطح دسترسی مدیریتشده ابری به عنوان راهی برای توسعهدهندگان گوگل کلود معرفی شد تا بدون ارسال توکن توسعهدهنده به عنوان بخشی از درخواست API، فراخوانیهای API را انجام دهند. اکنون که توکنهای توسعهدهنده منقضی شدهاند، این برنامه متوقف خواهد شد.
سطوح دسترسی توکن توسعهدهنده فعال شما به پروژه Google Cloud شما منتقل شده است، بنابراین کد موجود شما باید بدون هیچ تغییری به کار خود ادامه دهد. اگر نیاز به استفاده از یک پروژه Google Cloud جدید دارید، باید برای دسترسی به API از صفحه نمای کلی API تبلیغات گوگل پروژه Google Cloud خود درخواست دهید.
توکن توسعهدهنده من بخشی از یک لیست مجاز بود. چگونه تحت تأثیر قرار میگیرم؟
گوگل ممکن است برنامههای آزمایشی اجرا کند که به برخی از توسعهدهندگان امکان دسترسی به ویژگیهای آزمایشی را میدهد. دسترسی به این ویژگیها گاهی اوقات با اضافه کردن توکن توسعهدهنده شما به لیست مجاز فراهم میشود. اگر شما بخشی از چنین برنامه آزمایشی بودهاید، نیازی به انجام هیچ اقدامی از طرف شما نیست.
ما تمام برنامههای آزمایشی را بهروزرسانی کردهایم تا از پروژههای Google Cloud به جای توکنهای توسعهدهنده به عنوان مکانیزم فهرست مجاز استفاده کنند و وضعیت فهرست مجاز توکن توسعهدهنده را به پروژههای Google Cloud مرتبط منتقل کردهایم. کد موجود شما باید بدون هیچ تغییری به کار خود ادامه دهد. اگر همچنان با مشکل مواجه هستید، با مدیر حساب Google خود که شما را در برنامه آزمایشی ثبتنام کرده است، تماس بگیرید.
من یک توکن توسعهدهنده تأیید شده دارم و میخواهم از آن در یک پروژه جدید Google Cloud استفاده کنم. آیا این کار مجاز است؟
خیر، شما نمیتوانید از یک پروژه جدید گوگل کلود با توکن توسعهدهنده تایید شده خود استفاده کنید. از آنجایی که شما هرگز از توکن توسعهدهنده تایید شده خود با پروژه جدید گوگل کلود قبل از ۹ سپتامبر ۲۰۲۶ استفاده نکردهاید، سطوح دسترسی آن به پروژه ابری منتقل نشده است. اگر سعی کنید با این توکن توسعهدهنده یک فراخوانی API انجام دهید، خطای CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION را دریافت خواهیم کرد، زیرا توکنهای توسعهدهنده دیگر برای تعیین سطوح دسترسی API شما استفاده نمیشوند. برای رفع خطا، برای دسترسی API مناسب از صفحه نمای کلی API تبلیغات گوگل پروژه گوگل کلود خود درخواست دهید. به یک مثال مراجعه کنید.
توکن توسعهدهنده من به صورت خارجی فاش شده است. آیا باید توکن توسعهدهنده خود را مجدداً تنظیم کنم؟
خیر، در این مورد نیازی به تنظیم مجدد توکن توسعهدهنده ندارید. از آنجایی که ما سطوح دسترسی API توکن توسعهدهنده شما را به پروژه Google Cloud شما منتقل کردهایم، یک کاربر غیرمجاز دیگر نمیتواند از توکن توسعهدهنده شما با پروژه Google Cloud خود استفاده کند.
چه اتفاقی برای مرکز API میافتد؟
صفحه API Center موجود در حساب مدیریت تبلیغات گوگل منسوخ شده و در آینده نزدیک حذف خواهد شد. اگر از قبل توکن توسعهدهنده دارید، همچنان میتوانید وارد حساب مدیریت تبلیغات گوگل خود شوید و جزئیات را مشاهده کنید. با این حال، این جزئیات فقط برای اطلاع شما ارائه شدهاند. هیچ کاری مربوط به سطوح دسترسی توکن توسعهدهنده، مانند درخواست برای سطوح دسترسی بالاتر API، را از این صفحه انجام ندهید.
اگر نیاز به درخواست سطوح دسترسی بالاتر به API دارید، باید این کار را از صفحه نمای کلی API تبلیغات گوگل (Google Ads API Overview) پروژه گوگل کلود خود انجام دهید.
آیا برای استفاده از API گوگل ادز، هنوز به حساب کاربری مدیریت گوگل ادز نیاز دارم؟
دیگر برای استفاده از API گوگل ادز نیازی به حساب کاربری مدیریت تبلیغات گوگل ندارید. فقط در صورتی به حساب کاربری مدیریت نیاز دارید که نیاز به اتصال و مدیریت چندین حساب با استفاده از API داشته باشید.
من یک توسعهدهنده جدید هستم. چگونه میتوانم در API تبلیغات گوگل ثبتنام کنم؟
برای ثبت نام در API گوگل ادز، دستورالعملهای راهنمای شروع به کار را دنبال کنید. برای دریافت توکن توسعهدهنده از مرکز API حساب مدیریت گوگل ادز خود ثبت نام نکنید؛ این درخواستها پردازش نخواهند شد. مرکز API در آینده نزدیک غیرفعال خواهد شد.
برای مدیریت سطوح دسترسی API به چه مجوزهای IAM نیاز است؟
برای مدیریت سطوح دسترسی API تبلیغات گوگل، به مجوزهای مدیریت سهمیه برای پروژه Google Cloud خود نیاز دارید. مجوزهای لازم به طور پیشفرض برای نقشهای زیر در نظر گرفته شدهاند: مالک، ویرایشگر، مدیر سهمیه و مدیر استفاده از سرویس. برای اطلاعات بیشتر به مستندات مجوزهای سهمیه مراجعه کنید.
میتوانید صفحه IAM مربوط به پروژه گوگل کلود خود را بررسی کنید تا نقشهای اختصاص داده شده به خود را مشاهده کنید. برای اعطای نقشهای IAM لازم برای پروژه گوگل کلود خود، با مدیر پروژه گوگل کلود خود همکاری کنید.