توکن توسعه دهنده یک رشته الفبایی 22 کاراکتری است که به برنامه شما امکان می دهد به API Google Ads متصل شود. می‌توانید با ثبت‌نام در صفحه API Center حساب مدیر Google Ads یکی از آن‌ها را دریافت کنید. هر زمان که یک تماس API برقرار می کنید، با تنظیم سربرگ http یا gRPC developer-token توکن توسعه دهنده را به عنوان بخشی از درخواست ارسال می کنید.
به هر توکن توسعه‌دهنده سطح دسترسی اختصاص داده می‌شود که تعداد تماس‌های API را که می‌توانید در روز با توکن برقرار کنید و همچنین محیطی را که می‌توانید با آن تماس برقرار کنید، کنترل می‌کند. هنگامی که برای یک توکن توسعه دهنده ثبت نام می کنید، به طور پیش فرض دارای سطح دسترسی تست است. این به شما امکان می‌دهد فقط با حساب‌های آزمایشی تماس‌های API برقرار کنید. برای برقراری تماس های API با حساب تولیدی خود، باید سطح دسترسی پایه یا سطح دسترسی استاندارد را برای توکن توسعه دهنده خود درخواست کنید. هنگامی که درخواست توکن توسعه دهنده شما بررسی و تایید شد، توکن توسعه دهنده شما سطح دسترسی مناسب را دریافت می کند.
آیا به یک توکن توسعه دهنده جدید نیاز دارید؟
اینکه آیا باید برای یک توکن توسعه دهنده جدید ثبت نام کنید یا نه به چند عامل بستگی دارد. در اینجا چند سناریو رایج وجود دارد:
سناریو | مراحل بعدی |
| شرکت شما قبلاً هرگز از Google Ads API استفاده نکرده است و شما می خواهید برنامه های خود را توسعه دهید | برای یک توکن توسعه دهنده جدید ثبت نام کنید. بیشتر بدانید |
| شرکت شما به طور فعال از Google Ads API در گذشته استفاده کرده یا از آن استفاده کرده است | Google معمولاً به هر شرکت یک توکن توسعه دهنده اعطا می کند، بنابراین اگر شرکت شما قبلاً از Google Ads API استفاده می کند، باید از توکن توسعه دهنده موجود خود دوباره استفاده کنید. بیشتر بدانید |
| شرکت شما قبلاً از Google Ads API استفاده می‌کند، اما در حال توسعه یک محصول یا ابزار جدید است | اگر مطمئن هستید که نمی‌توانید از توکن توسعه‌دهنده موجود خود استفاده کنید، می‌توانید برای توضیح مورد استفاده خود در برنامه برای یک توکن جدید درخواست دهید. برای بقیه این راهنما، می توانید از توکن توسعه دهنده موجود خود استفاده کنید. بیشتر بدانید |
| شرکت شما از یک برنامه شخص ثالث استفاده می کند | تنها در صورتی که در حال توسعه اپلیکیشن خود هستید، به توکن توسعه دهنده نیاز دارید. اگر از یک برنامه یا سرویس شخص ثالث استفاده می کنید، توسعه دهنده آن برنامه باید یک توکن توسعه دهنده برای برنامه دریافت کند. اگر در مورد پرونده خود نامشخص هستید، با تیم سازگاری API تماس بگیرید . |
نحوه درخواست توکن توسعه دهنده
هنگام درخواست توکن توسعه دهنده دو مرحله وجود دارد.
مرحله 1: یک حساب مدیر Google Ads را انتخاب یا ایجاد کنید
اگر قبلاً یک حساب مدیر Google Ads دارید، هنگام درخواست توکن، آن را انتخاب کنید. اگر این حساب مدیر قبلاً به حساب‌های دیگر شما مرتبط نیست، توصیه می‌کنیم آن را در ریشه سلسله مراتب حساب خود قرار دهید تا روند بررسی نشانه‌ها آسان شود و بعداً مدیریت حساب را ساده کنید.
اگر حساب مدیر ندارید، می‌توانید دستورالعمل‌های مرکز راهنمایی را برای ایجاد آن دنبال کنید.
مرحله 2: برای دسترسی به API Google Ads درخواست دهید
توجه داشته باشید که تکمیل فرآیند بررسی توکن توسعه‌دهنده ممکن است کمی طول بکشد. بیشتر بدانید .
در مرورگر وب خود به https://ads.google.com/aw/apicenter بروید. در صورت درخواست وارد حساب مدیر Google Ads خود شوید.
فرم دسترسی API را تکمیل کنید و شرایط و ضوابط را بپذیرید.
اطمینان حاصل کنید که اطلاعات شما صحیح است و URL وب سایت شرکت شما کار می کند. اگر وب سایت فعال نباشد، ممکن است Google نتواند درخواست شما را پردازش کند و آن را رد کند.
مطمئن شوید که ایمیل تماس API که ارائه می‌دهید به یک صندوق ورودی که به طور منظم نظارت می‌شود منتهی شود. تیم انطباق API Google ممکن است در طول فرآیند بررسی برای شفاف سازی با این آدرس ایمیل تماس بگیرد. اگر امکان دسترسی به شما وجود ندارد، ممکن است Google به برنامه شما ادامه ندهد.
می‌توانید ایمیل تماس API خود را در مرکز API ویرایش کنید. این اطلاعات را حتی پس از فرآیند درخواست به‌روز نگه دارید تا Google بتواند اعلان‌های خدمات مهم را برای شما ارسال کند.
پس از تکمیل فرآیند درخواست، توکن توسعه دهنده در مرکز API شما با وضعیت تأیید در انتظار ظاهر می شود. نشانه توسعه‌دهنده شما اکنون دارای سطح دسترسی به حساب آزمایشی است و می‌توانید تماس‌های API را علیه حساب‌های آزمایشی شروع کنید.
بررسی کنید که آیا به یک حساب مدیر وارد شده اید یا خیر
برای دسترسی به رمز توسعه دهنده خود باید به حساب مدیر خود وارد شوید، و این نمی تواند یک حساب مدیر آزمایشی باشد.
برای تأیید اینکه آیا به حساب مدیر وارد شده اید، این مراحل را دنبال کنید:
در مرورگر وب خود به https://ads.google.com/aw/apicenter بروید.
اگر به حساب مشتری وارد شده باشید، صفحه نمایش داده می شود مرکز API فقط برای حساب های مدیر در دسترس است. .
اگر حساب آزمایشی به رنگ قرمز در گوشه سمت راست بالا ظاهر می‌شود، حساب شما یک مدیر آزمایشی یا یک تبلیغ‌کننده آزمایشی است.
کجا توکن توسعه دهنده خود را پیدا کنید
می‌توانید توکن توسعه‌دهنده را، در صورت وجود، در صفحه API Center حساب مدیر Google Ads خود پیدا کنید.