به هر توکن برنامه‌نویس Google Ads API یک سطح دسترسی و «استفاده مجاز» اختصاص داده شده است. سطح دسترسی تعیین می‌کند که آیا می‌توانید بر حساب‌های تولید و تعداد عملیات و درخواست‌هایی که می‌توانید روزانه انجام دهید تأثیر بگذارید. استفاده مجاز، ویژگی‌های خاص Google Ads API را مشخص می‌کند که توکن توسعه‌دهنده مجاز به استفاده از آن‌ها است.
سطوح دسترسی
سه سطح دسترسی مختلف به ترتیب در جدول ذکر شده است. اگر قبلاً به Google Ads API دسترسی ندارید، می توانید با ثبت نام برای دسترسی به حساب آزمایشی شروع کنید. می توانید با انجام چند مرحله اضافی در برنامه، سطح دسترسی را افزایش دهید.
| سطح دسترسی | امکان دسترسی به ... | حد عملیات روزانه 1 | درخواست کنید |
|---|---|---|---|
| تست دسترسی به حساب | حساب های آزمایشی | 15000 عملیات در روز | دستورالعمل ها |
| دسترسی اولیه | حساب های تست و تولید | 15000 عملیات در روز | دستورالعمل ها |
| دسترسی استاندارد | حساب های تست و تولید | عملیات نامحدود / روز | دستورالعمل ها |
1 "در روز" بر اساس یک دوره زمانی 24 ساعته کشویی است که در آن درخواست های API با توکن توسعه دهنده شما انجام شده است. اگر برنامه شما در 24 ساعت گذشته از حد درخواست برای سطح دسترسی شما بیشتر شود، خطایی دریافت می کند.
تست دسترسی به حساب
پس از تکمیل ثبت نام اولیه برای Google Ads API، یک توکن توسعه دهنده با سطح دسترسی حساب آزمایشی برای شما صادر می شود. این بدان معنی است که توکن توسعه دهنده فقط می تواند درخواست های Google Ads API را در برابر حساب های آزمایشی ارائه دهد.
درخواست برای دسترسی به حساب آزمایشی
ثبت نام Google Ads API را در رابط وب Google Ads تکمیل کنید تا به طور خودکار سطح دسترسی حساب آزمایشی به شما داده شود.
دسترسی اولیه
دسترسی اولیه به توکن توسعه‌دهنده اجازه می‌دهد تا درخواست‌های Google Ads API را هم در برابر حساب‌های آزمایشی و هم برای حساب‌های تولیدی ارسال کند. حساب‌های تولیدی به هر حسابی گفته می‌شود که تبلیغات واقعی و واقعی Google ارائه می‌کند—حساب‌های آزمایشی تبلیغاتی را ارائه نمی‌کنند.
سطح دسترسی پایه به توکن توسعه دهنده اجازه می دهد تا حداکثر 15000 عملیات در روز را اجرا کند. این برای اکثر توسعه دهندگان کافی است.
درخواست برای دسترسی پایه
اگر نشانه توسعه دهنده سطح دسترسی به حساب آزمایشی دارید و می خواهید برای دسترسی به حساب تولیدی درخواست دهید، فرم درخواست دسترسی اولیه را پر کنید . مطمئن شوید که این مراحل را کامل کرده اید:
- اطمینان حاصل کنید که از قبل یک توکن توسعه دهنده با سطح دسترسی به حساب آزمایشی دارید.
- اطمینان حاصل کنید که ایمیل تماس API در مرکز API به روز است. برای دیدن مرکز API باید به حساب مدیر خود وارد شوید. شما نمی توانید بدون یک آدرس ایمیل معتبر و مرتباً بررسی شده، فرآیند درخواست را تکمیل کنید. مطمئن شوید که همه حساب‌های Google Ads فعال خود را با توکن API به حساب مدیر مرتبط کرده‌اید.
دسترسی استاندارد
دسترسی استاندارد به توکن توسعه دهنده اجازه می دهد تا تعداد نامحدودی عملیات در روز را برای اکثر سرویس ها انجام دهد. این شامل Search GoogleAdsService و SearchStream است، اما محدود به آن نیست. برای جزئیات بیشتر در مورد محدودیت ها و استثناهای دسترسی استاندارد، سهمیه های API را ببینید.
سطح دسترسی استاندارد فقط به توسعه دهندگانی اعطا می شود که به عملیات نامحدود Google Ads API نیاز دارند، مانند شرکت های بزرگ یا ابزارهایی که به بسیاری از کاربران خدمات ارائه می دهند.
صرف نظر از سطح دسترسی، همه عملیات API مشمول محدودیت‌های نرخ سیستم هستند. برای اطلاعات بیشتر در مورد نحوه رسیدگی به خطاهای محدودیت نرخ، به انواع خطا مراجعه کنید.
درخواست برای دسترسی استاندارد
اگر در حال حاضر سطح دسترسی اولیه دارید و می‌خواهید برای عملیات نامحدود Google Ads API درخواست دهید، فرم درخواست دسترسی استاندارد را پر کنید .
اگر ابزار شما خارجی است، آماده باشید تا دسترسی ورود به سیستم نمایشی را به ابزار خود ارائه دهید. توجه داشته باشید که ابزار شما باید با حداقل عملکرد مورد نیاز مطابقت داشته باشد.
استفاده مجاز
استفاده مجاز فقط برای توکن های دسترسی اولیه و استاندارد اعمال می شود. استفاده مجاز بر اساس استفاده مورد نظر از Google Ads API اختصاص داده شده است. این مجوزها تعیین می کنند که یک توکن برای کدام ویژگی های API می تواند استفاده شود، همانطور که در جدول زیر توضیح داده شده است:
| استفاده مجاز | توضیحات |
|---|---|
| ایجاد / مدیریت تبلیغات | برای ایجاد و مدیریت کمپین‌ها، گروه‌های تبلیغاتی، تبلیغات و کلمات کلیدی به همه سرویس‌های API دسترسی داشته باشید. |
| گزارش دهی | فقط درخواست‌های GoogleAdsService.Search یا GoogleAdsService.SearchStream یا تماس‌های فقط خواندنی را انجام دهید. این برای توسعه دهندگانی است که فقط از API برای درخواست آمار استفاده می کنند. |
| تحقیق در مورد کلمات کلیدی و توصیه ها | به توکن اجازه دسترسی به RecommendationService، KeywordPlanIdeaService و KeywordPlanService را بدهید. این فقط توسط ابزارهایی استفاده می‌شود که به پیشنهادهایی برای کمک به ایجاد و مدیریت کمپین‌های Google Ads نیاز دارند. |
تغییر کاربری مجاز
اگر برای سطح دسترسی اولیه یا استاندارد تأیید شده‌اید، می‌توانید درخواست را برای به‌روزرسانی استفاده مجاز پر کنید. اگر می خواهید استفاده مجاز خود را به روز کنید یا به مشتریان خود اجازه دسترسی به ابزار خود را بدهید، برنامه را پر کنید.