یک توکن توسعه دهنده از Google به برنامه شما امکان می دهد به API Google Ads متصل شود. به هر توکن توسعه‌دهنده سطح دسترسی اختصاص داده می‌شود که تعداد تماس‌های API را که می‌توانید در روز با توکن برقرار کنید و همچنین محیطی را که می‌توانید با آن تماس برقرار کنید، کنترل می‌کند. بیشتر بدانید .
هر پروژه Google API Console را می توان با توکن توسعه دهنده تنها از یک حساب مدیر مرتبط کرد. هنگامی که یک درخواست Google Ads API ارائه می کنید، توکن توسعه دهنده به طور دائم با پروژه Google API Console جفت می شود.
اگر تحت یک حساب مدیر جدید به کد برنامه‌نویس تغییر دهید، ابتدا باید یک پروژه کنسول API Google جدید برای درخواست‌های Google Ads API ایجاد کنید که از نشانه مدیر جدید استفاده می‌کند. اگر از پروژه Google API Console جدید استفاده نکنید، هنگام درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد.
روش
مرحله 1: یک حساب مدیر Google Ads را انتخاب یا ایجاد کنید
قبل از درخواست توکن توسعه دهنده، ابتدا باید یک حساب مدیر Google Ads داشته باشید.
حساب‌های مدیر را نمی‌توان با استفاده از همان آدرس ایمیل یک حساب Google Ads موجود ایجاد کرد. بنابراین باید از آدرس ایمیلی استفاده کنید که قبلاً با حساب Google Ads مرتبط نشده است تا حساب مدیر خود را ایجاد کنید.
توجه داشته باشید که حساب مدیری که انتخاب می‌کنید تأثیری بر مجموعه حساب‌های Google Ads که توکن توسعه‌دهنده شما می‌تواند به آن‌ها دسترسی داشته باشد، ندارد. فقط برای نگه داشتن توکن توسعه دهنده استفاده می شود.
تا زمانی که شما دارای اعتبارنامه OAuth مناسب باشید، خود توکن می تواند به هر حسابی دسترسی داشته باشد. با این حال، پیوند دادن این حساب مدیر به حساب‌های Google Ads فعال شرکت شما، روند بررسی برنامه را ساده‌تر می‌کند و تعداد دفعاتی را که برای مدیریت حساب‌های خود با API نیاز به انجام فرآیند احراز هویت دارید، کاهش می‌دهد. برای جزئیات، به مقاله مرکز راهنمایی درباره پیوند دادن حساب‌ها مراجعه کنید.
مرحله 2: برای دسترسی به API Google Ads درخواست دهید
از طریق حساب مدیر خود برای دسترسی به API Google Ads ثبت نام کنید. وارد شوید ، سپس به ToOLS & SETTINGS > SETUP > API Center بروید. گزینه API Center فقط برای حساب‌های مدیر Google Ads ظاهر می‌شود.
تمام فیلدهای فرم دسترسی API باید تکمیل شود و شرایط و ضوابط پذیرفته شود. اطمینان حاصل کنید که اطلاعات شما صحیح است و URL وب سایت شرکت شما کار می کند. اگر وب‌سایت یک صفحه زنده نباشد، نمی‌توانیم درخواست شما را پردازش کنیم.
مطمئن شوید که ایمیل تماس API که ارائه می‌دهید به یک صندوق ورودی که به طور منظم نظارت می‌شود منتهی شود. اگر نتوانیم با این آدرس ایمیل با شما تماس بگیریم، نمی‌توانیم درخواست شما را پردازش کنیم و رد می‌شود.
می‌توانید ایمیل تماس API خود را در مرکز API ویرایش کنید.
ما قویاً شما را تشویق می کنیم که این اطلاعات را حتی پس از فرآیند درخواست به روز نگه دارید تا بتوانیم اطلاعیه های خدمات مهم را برای شما ارسال کنیم.
مرحله 3: درخواست خود را ادامه دهید
توکن برنامه‌نویس معلق شما باید قبل از استفاده از آن با حساب‌های تولیدی Google Ads تأیید شود. می توانید برای دسترسی پایه یا استاندارد دسترسی درخواست دهید.
اگر انتظار می رود میزان استفاده از API شما حداقل باشد ، برای دسترسی اولیه درخواست دهید .
اگر انتظار می رود میزان استفاده از API شما زیاد باشد ، برای دسترسی استاندارد درخواست دهید .
برای تعیین اینکه آیا به دسترسی پایه یا استاندارد دسترسی دارید به برگه نرخ مراجعه کنید. اگر در مورد استفاده از API آینده خود مطمئن نیستید، توصیه می کنیم با دسترسی پایه شروع کنید و زمانی که استفاده از API برنامه شما به محدودیت های سهمیه اعمال شده توسط Basic Access به طور مکرر نزدیک شد، آن را به دسترسی استاندارد ارتقا دهید.
هر دو برنامه دسترسی پایه و دسترسی استاندارد بررسی می‌شوند تا اطمینان حاصل شود که ابزار یا برنامه نرم‌افزاری که پیشنهاد می‌کنید با Google Ads API استفاده کنید با شرایط و ضوابط و خط‌مشی‌های ما، از جمله حداقل عملکرد مورد نیاز (RMF) (در صورت وجود) مطابقت دارد. اگر شرکت شما حساب‌های Google Ads را برای مشتریان مدیریت می‌کند، برای دسترسی به Google Ads API باید از خط‌مشی شخص ثالث ما پیروی کنید.
ما معمولاً ظرف دو روز کاری از تاریخی که درخواست خود را ارسال کردید، با آدرس ایمیلی که در مرحله 2 ارائه کرده‌اید، با شما تماس می‌گیریم. اگر دیگر به این صندوق ورودی دسترسی ندارید، یا اگر قصد ندارید به طور فعال این آدرس ایمیل را نظارت کنید، آدرس ایمیل خود را در مرکز API با دنبال کردن دستورالعمل‌های بالا در مرحله 2 ویرایش کنید تا بتوانیم با شما تماس بگیریم.
تیم بررسی توکن توکن توسعه دهنده من را تایید کرده است
پس از تأیید درخواست شما برای دسترسی به API، توکن توسعه دهنده اختصاص داده شده شما برای محیط تولید فعال می شود. رمز شما از طریق مرکز API شما در دسترس خواهد بود — از طریق منوی تنظیمات حساب برای حساب مدیری که از آن درخواست داده اید قابل دسترسی است. هنگام تعامل با سیستم ما، می‌توانید با قرار دادن آن در سرصفحه‌های درخواست خود به API دسترسی پیدا کنید.
بسیار مهم است که ایمیل تماس خود را به روز نگه دارید، زیرا ما اطلاعات مهم در مورد تغییرات یا اختلالات را به آدرس ایمیلی که شما مشخص کرده اید ارسال می کنیم.
اگر در آینده تغییری در ابزار خود ایجاد کنید، باید این تغییرات را با پر کردن فرم تغییر ابزار Google Ads API به Google گزارش دهید.
تیم بررسی رمز درخواست من را رد کرده است
تیم بررسی Token اطلاعاتی را که هنگام درخواست دسترسی به Google Ads API ارائه می‌دهید بررسی می‌کند تا مطمئن شود نرم‌افزار شما به شرایط و ضوابط API Google Ads (T&C) و همچنین حداقل عملکرد مورد نیاز (RMF) (در صورت وجود) پایبند است. .
دلایل رایج برای رد درخواست عبارتند از:
- ما نمی‌توانیم با آدرس ایمیل تماسی که ارائه کرده‌اید با شما ارتباط برقرار کنیم.
- شما درخواست داده اید زیرا ابزاری که از شخص ثالث استفاده می کنید به توکن توسعه دهنده نیاز دارد.
- درخواست شما سایر مقررات مندرج در شرایط و ضوابط را نقض می کند.
- برنامه شما عناصر مورد نیاز حداقل عملکرد مورد نیاز (در صورت وجود) را اجرا نمی کند.
اگر ابزار API خود را برای پیروی از خط‌مشی Google Ads API تغییر داده‌اید، یا اگر فکر می‌کنید درخواست شما به اشتباه رد شده است، می‌توانید با کلیک کردن روی پیوند درخواست مجدد در صفحه مرکز API حساب مدیر خود، درخواست مجدد بدهید.
اگر در مدت زمان مورد انتظار ایمیلی درباره برنامه خود از ما دریافت نکردید، با تیم Google Ads API Compliance تماس بگیرید .
صورتحساب
هیچ هزینه ای برای استفاده از Google Ads API وجود ندارد. ما هزینه های عدم انطباق را برای عدم رعایت حداقل عملکرد مورد نیاز دریافت می کنیم. برای جزئیات بیشتر به برگه نرخ مراجعه کنید.