توکن توسعه دهنده یک رشته الفبایی 22 کاراکتری است که به برنامه شما امکان می دهد به API Google Ads متصل شود. پس از اینکه توکن توسط Google به شما اختصاص داده شد، می‌توانید آن را مشاهده کنید یا در صفحه API Center حساب مدیر Google Ads خود یک نشانه جدید ایجاد کنید.
به هر توکن توسعه‌دهنده سطح دسترسی اختصاص داده می‌شود که تعداد تماس‌های 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 درخواست دهید
توجه داشته باشید که تکمیل فرآیند بررسی توکن توسعه‌دهنده ممکن است کمی طول بکشد. بیشتر بدانید .
به حساب مدیر خود وارد شوید . می توانید بررسی کنید که آیا این یک حساب مدیر است.
در نوار جستجو در بالای صفحه، "api center" را وارد کرده و آن را از تکمیل خودکار جستجو انتخاب کنید. گزینه API Center فقط برای حساب‌های مدیر Google Ads و نه برای حساب‌های مشتری یا حساب‌های مدیر آزمایشی ظاهر می‌شود.
فرم دسترسی API را تکمیل کنید و شرایط و ضوابط را بپذیرید.
اطمینان حاصل کنید که اطلاعات شما صحیح است و URL وب سایت شرکت شما کار می کند. اگر وب سایت فعال نباشد، ممکن است Google نتواند درخواست شما را پردازش کند و آن را رد کند.
مطمئن شوید که ایمیل تماس API که ارائه می‌دهید به یک صندوق ورودی که به طور منظم نظارت می‌شود منتهی شود. تیم انطباق API Google ممکن است در طول فرآیند بررسی برای شفاف سازی با این آدرس ایمیل تماس بگیرد. اگر امکان دسترسی به شما وجود ندارد، ممکن است Google به برنامه شما ادامه ندهد.
می‌توانید ایمیل تماس API خود را در مرکز API ویرایش کنید. این اطلاعات را حتی پس از فرآیند درخواست به‌روز نگه دارید تا Google بتواند اعلان‌های خدمات مهم را برای شما ارسال کند.
پس از تکمیل فرآیند درخواست، توکن توسعه دهنده در مرکز API شما با وضعیت تأیید در انتظار ظاهر می شود. رمز توسعه‌دهنده شما اکنون سطح دسترسی آزمایشی دارد و می‌توانید تماس‌های API را علیه حساب‌های آزمایشی شروع کنید.
پس از اینکه توکن توسعه دهنده خود را دریافت کردید، به ارزش آن توجه کنید زیرا هنگام برقراری اولین تماس API خود به آن نیاز خواهید داشت.
بررسی کنید که آیا به یک حساب مدیر وارد شده اید یا خیر
برای دسترسی به رمز توسعه دهنده خود باید به حساب مدیر خود وارد شوید، و این نمی تواند یک حساب مدیر آزمایشی باشد.
برای تأیید اینکه آیا به حساب مدیر وارد شده اید، این مراحل را دنبال کنید:
وارد حساب کاربری خود شوید
Admin را در سمت چپ انتخاب کنید. اگر تنظیمات حساب مدیر را در بالا سمت چپ مشاهده کردید، به حساب مدیر خود وارد شده‌اید. اگر تنظیمات حساب را مشاهده کردید، به حساب مشتری وارد شده اید.
اگر حساب آزمایشی با رنگ قرمز در گوشه سمت راست بالا نشان داده شود، حساب شما یا یک مدیر آزمایشی یا یک تبلیغ‌کننده آزمایشی است.
کجا توکن توسعه دهنده خود را پیدا کنید
می‌توانید توکن توسعه‌دهنده را، در صورت وجود، در صفحه API Center حساب مدیر Google Ads خود پیدا کنید.
به حساب مدیر خود وارد شوید . می توانید بررسی کنید که آیا این یک حساب مدیر است.
در نوار جستجو در بالای صفحه، "api center" را تایپ کرده و آن را از تکمیل خودکار جستجو انتخاب کنید. گزینه API Center فقط برای حساب‌های مدیر Google Ads و نه برای حساب‌های مدیر آزمایشی ظاهر می‌شود.
توکن توسعه دهنده و سطح دسترسی آن اولین مقادیری هستند که در زیر API Access فهرست شده اند.