توکن توسعه‌دهنده یک رشته الفبایی-عددی ۲۲ کاراکتری است که به برنامه شما اجازه می‌دهد به API گوگل ادز متصل شود. می‌توانید با ثبت‌نام در صفحه مرکز API حساب کاربری گوگل ادز خود، یکی از آنها را دریافت کنید. هر زمان که یک فراخوانی API انجام می‌دهید، توکن توسعه‌دهنده را به عنوان بخشی از درخواست با تنظیم developer-token ارسال می‌کنید.
به هر توکن توسعه‌دهنده یک سطح دسترسی اختصاص داده می‌شود که تعداد فراخوانی‌های API که می‌توانید در روز با آن توکن انجام دهید و همچنین محیطی که می‌توانید فراخوانی‌ها را در آن انجام دهید، کنترل می‌کند.
وقتی برای یک توکن توسعه‌دهنده ثبت‌نام می‌کنید، ممکن است به طور پیش‌فرض سطح دسترسی اکسپلورر به شما اعطا شود. این به شما امکان می‌دهد تا با حساب‌های کاربری اصلی تماس برقرار کنید، اما با محدودیت‌های خاصی. در موارد خاصی که ما نمی‌توانیم درخواست توکن توسعه‌دهنده شما را به طور خودکار بررسی کنیم، ممکن است به جای آن، به توکن توسعه‌دهنده شما یک سطح دسترسی حساب آزمایشی اعطا کنیم. این به شما امکان می‌دهد تا فقط با حساب‌های آزمایشی تماس‌های API برقرار کنید. برای حذف محدودیت‌های سطوح دسترسی اکسپلورر و حساب آزمایشی، باید سطح دسترسی پایه یا سطح دسترسی استاندارد را برای توکن توسعه‌دهنده خود درخواست کنید. پس از بررسی و تأیید درخواست توکن توسعه‌دهنده، سطح دسترسی مناسب به توکن توسعه‌دهنده شما اعطا خواهد شد.
آیا به یک توکن توسعه‌دهنده جدید نیاز دارید؟
اینکه آیا باید برای یک توکن توسعه‌دهنده جدید ثبت‌نام کنید یا خیر، به چند عامل بستگی دارد. در اینجا چند سناریوی رایج آورده شده است:
سناریو | مراحل بعدی |
| شرکت شما قبلاً هرگز از API تبلیغات گوگل استفاده نکرده است و می‌خواهید برنامه‌های خودتان را توسعه دهید. | برای دریافت توکن توسعه‌دهنده جدید ثبت‌نام کنید. اطلاعات بیشتر |
| شرکت شما به طور فعال از API تبلیغات گوگل استفاده می‌کند یا در گذشته از آن استفاده کرده است | گوگل معمولاً به هر شرکت یک توکن توسعه‌دهنده اعطا می‌کند، بنابراین اگر شرکت شما از قبل از API تبلیغات گوگل استفاده می‌کند، باید از توکن توسعه‌دهنده موجود خود دوباره استفاده کنید. اطلاعات بیشتر |
| شرکت شما از قبل از API گوگل ادز استفاده می‌کند، اما در حال توسعه یک محصول یا ابزار جدید نیز هست. | اگر مطمئن هستید که نمی‌توانید از توکن توسعه‌دهنده فعلی خود استفاده کنید، می‌توانید درخواست توکن جدیدی بدهید و کاربرد آن را در برنامه توضیح دهید. برای ادامه این راهنما، می‌توانید از توکن توسعه‌دهنده فعلی خود استفاده کنید. اطلاعات بیشتر |
| شرکت شما از یک برنامه شخص ثالث استفاده می‌کند | فقط در صورتی به توکن توسعه‌دهنده نیاز دارید که در حال توسعه برنامه خودتان باشید. اگر از یک برنامه یا سرویس شخص ثالث استفاده می‌کنید، توسعه‌دهنده آن برنامه باید یک توکن توسعه‌دهنده برای برنامه دریافت کند. اگر در مورد پرونده خود مطمئن نیستید، با تیم انطباق API تماس بگیرید . |
چه کسی می‌تواند برای دریافت توکن توسعه‌دهندگان اقدام کند؟
هم شرکت‌ها و هم توسعه‌دهندگان انفرادی می‌توانند برای دریافت توکن توسعه‌دهنده درخواست دهند. جدول زیر خلاصه‌ای از جزئیاتی است که هنگام ثبت نام برای دریافت توکن توسعه‌دهنده باید ارائه دهید.
| اگر شما هستید | سپس جزئیات توسعه‌دهنده زیر را ارائه دهید | یادداشت‌های تکمیلی |
|---|---|---|
| یک توسعه‌دهنده که نماینده شرکت شما یا یک تیم محصول است | نام شرکت شما و آدرس اینترنتی شرکت شما | گوگل معمولاً به هر شرکت یک توکن توسعه‌دهنده اعطا می‌کند، اما توکن‌های توسعه‌دهنده جداگانه‌ای را برای ابزارهای جداگانه و به صورت موردی تأیید می‌کند. |
| یک توسعه‌دهنده‌ی شخصی که نماینده‌ی یک شرکت نیست | نام شرکت خود را Individual قرار دهید. می‌توانید به جای URL شرکت، URLهای جایگزین مانند URL پروفایل GitHub یا URL پروفایل LinkedIn خود را ارائه دهید. | شما به نوعی حضور آنلاین نیاز دارید و باید یک URL به گوگل ارائه دهید که به ما در ارزیابی آنچه که قصد دارید با API تبلیغات گوگل انجام دهید، کمک کند. URL های عمومی مانند test.com و example.com پذیرفته نمی‌شوند. |
نحوه درخواست توکن توسعه‌دهندگان
هنگام درخواست توکن توسعه‌دهنده، دو مرحله وجود دارد.
مرحله ۱: یک حساب مدیریت تبلیغات گوگل انتخاب یا ایجاد کنید
اگر از قبل یک حساب مدیریت تبلیغات گوگل دارید، هنگام درخواست توکن توسعه‌دهنده، آن را انتخاب کنید. اگر این حساب مدیریت از قبل به سایر حساب‌های شما متصل نیست، توصیه می‌کنیم آن را در ریشه سلسله مراتب حساب خود قرار دهید تا فرآیند بررسی توکن آسان‌تر شود و مدیریت حساب بعداً ساده‌تر شود.
اگر حساب مدیر ندارید، می‌توانید دستورالعمل‌های مرکز راهنما را برای ایجاد آن دنبال کنید.
مرحله ۲: برای دسترسی به API تبلیغات گوگل درخواست دهید
توجه داشته باشید که فرآیند بررسی توکن توسعه‌دهنده می‌تواند مدتی طول بکشد. اطلاعات بیشتر .
در مرورگر وب خود به آدرس https://ads.google.com/aw/apicenter بروید. در صورت درخواست، وارد حساب مدیریت تبلیغات گوگل خود شوید.
فرم دسترسی به API را تکمیل کنید و شرایط و ضوابط را بپذیرید.
مطمئن شوید که اطلاعات شما صحیح است و آدرس وب‌سایت شرکت شما فعال است. اگر وب‌سایت فعال نباشد، ممکن است گوگل نتواند درخواست شما را پردازش کند و آن را رد کند.
مطمئن شوید که ایمیل تماس API که ارائه می‌دهید، به یک صندوق ورودی که مرتباً بررسی می‌شود، منتهی می‌شود. تیم انطباق API گوگل ممکن است در طول فرآیند بررسی برای توضیحات بیشتر با این آدرس ایمیل تماس بگیرد. اگر نتوانید با شما تماس بگیرید، ممکن است گوگل درخواست شما را ادامه ندهد.
شما می‌توانید ایمیل تماس API خود را در مرکز API ویرایش کنید. این اطلاعات را حتی پس از فرآیند درخواست، به‌روز نگه دارید تا گوگل بتواند اطلاعیه‌های مهم خدمات را برای شما ارسال کند.
پس از تکمیل فرآیند درخواست، توکن توسعه‌دهنده در مرکز API شما با یکی از نتایج زیر ظاهر می‌شود:
- توکن توسعه‌دهنده شما دارای سطح دسترسی اکسپلورر با وضعیت تأیید شده است . این بدان معناست که گوگل توانسته است به‌طور خودکار درخواست توکن توسعه‌دهنده شما را برای سطح دسترسی اکسپلورر بررسی و تأیید کند. می‌توانید فراخوانی‌های API را در حساب کاربری اصلی یا حساب کاربری آزمایشی خود آغاز کنید.
- توکن توسعه‌دهنده شما دارای سطح دسترسی حساب آزمایشی با وضعیت در انتظار تأیید است . این بدان معناست که گوگل نتوانسته است به‌طور خودکار درخواست توکن توسعه‌دهنده شما را برای سطح دسترسی اکسپلورر بررسی و تأیید کند. می‌توانید شروع به فراخوانی API برای حساب‌های آزمایشی کنید. پس از تکمیل این راهنما، توصیه می‌کنیم نحوه درخواست برای سطح دسترسی پایه را بررسی کنید.
تأیید کنید که آیا وارد حساب مدیر تبلیغات گوگل شده‌اید یا خیر
برای دسترسی به توکن توسعه‌دهنده، باید وارد حساب مدیریت تبلیغات گوگل خود شوید و این حساب نمی‌تواند یک حساب مدیریت تست تبلیغات گوگل باشد.
برای تأیید اینکه آیا وارد حساب مدیر تبلیغات گوگل شده‌اید، این مراحل را دنبال کنید:
در مرورگر وب خود به آدرس https://ads.google.com/aw/apicenter بروید.
اگر وارد حساب کاربری مشتری شده باشید، صفحه نمایش داده می‌شود: «مرکز API فقط برای حساب‌های مدیریتی در دسترس است. »
اگر حساب آزمایشی در گوشه بالا سمت راست به رنگ قرمز نمایش داده شود، حساب شما یا مدیر آزمایشی است یا تبلیغ‌کننده آزمایشی .
توکن توسعه‌دهنده خود را از کجا پیدا کنید
در صورت وجود، می‌توانید توکن توسعه‌دهنده را در صفحه مرکز API حساب مدیریت تبلیغات گوگل خود پیدا کنید.