به هر توکن توسعه‌دهنده API تبلیغات گوگل یک سطح دسترسی و «استفاده مجاز» اختصاص داده شده است. سطح دسترسی تعیین می‌کند که آیا می‌توانید روی حساب‌های تولید و تعداد عملیات و درخواست‌هایی که می‌توانید روزانه اجرا کنید، تأثیر بگذارید یا خیر. استفاده مجاز، ویژگی‌های خاص API تبلیغات گوگل را که توکن توسعه‌دهنده مجاز به استفاده از آنها است، تعیین می‌کند.
سطوح دسترسی
سه سطح دسترسی مختلف به ترتیب در جدول فهرست شده‌اند. اگر از قبل به API تبلیغات گوگل دسترسی ندارید، می‌توانید با ثبت‌نام برای دریافت دسترسی آزمایشی به حساب کاربری شروع کنید. می‌توانید با انجام برخی مراحل اضافی در برنامه، سطح دسترسی را افزایش دهید.
| سطح دسترسی | امکان دسترسی ... | محدودیت کارکرد روزانه ۱ | چگونه درخواست دهیم | بررسی‌ها معمولاً چقدر طول می‌کشد؟ |
|---|---|---|---|---|
| دسترسی به حساب آزمایشی | حساب‌های آزمایشی | ۱۵۰۰۰ عملیات در روز | دستورالعمل‌ها | فوری |
| دسترسی پایه | حساب‌های آزمایشی و تولیدی | ۱۵۰۰۰ عملیات در روز | دستورالعمل‌ها | ۲ روز کاری |
| دسترسی استاندارد | حساب‌های آزمایشی و تولیدی | عملیات نامحدود / روز | دستورالعمل‌ها | ۱۰ روز کاری |
۱. «در هر روز» بر اساس یک دوره زمانی متغیر ۲۴ ساعته است که در آن درخواست‌های API با توکن توسعه‌دهنده شما انجام شده است. اگر درخواست شما در ۲۴ ساعت گذشته از محدودیت درخواست برای سطح دسترسی شما فراتر رود، خطایی دریافت خواهد کرد.
دسترسی به حساب آزمایشی
پس از تکمیل ثبت نام اولیه برای API تبلیغات گوگل، یک توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی به شما داده می‌شود. این بدان معناست که توکن توسعه‌دهنده فقط می‌تواند درخواست‌های API تبلیغات گوگل را برای حساب‌های آزمایشی ارسال کند.
نحوه درخواست دسترسی به حساب آزمایشی
برای اینکه به طور خودکار سطح دسترسی آزمایشی به حساب کاربری به شما اعطا شود ، ثبت نام API گوگل ادز را در رابط وب گوگل ادز تکمیل کنید.
دسترسی پایه
سطح دسترسی پایه به توکن توسعه‌دهنده اجازه می‌دهد تا درخواست‌های API تبلیغات گوگل را هم برای حساب‌های آزمایشی و هم برای حساب‌های عملیاتی ارسال کند. حساب‌های عملیاتی هر حسابی هستند که تبلیغات واقعی و زنده گوگل را ارائه می‌دهند - حساب‌های آزمایشی تبلیغات را ارائه نمی‌دهند.
سطح دسترسی پایه به توکن توسعه‌دهنده اجازه می‌دهد تا روزانه تا ۱۵۰۰۰ عملیات انجام دهد. این برای اکثر توسعه‌دهندگان کافی است.
نحوه درخواست دسترسی پایه
اگر توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی دارید و می‌خواهید برای دسترسی به حساب عملیاتی درخواست دهید، فرم درخواست دسترسی پایه را پر کنید . مطمئن شوید که این مراحل را انجام داده‌اید:
- مطمئن شوید که از قبل یک توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی دارید.
- مطمئن شوید که ایمیل تماس API در مرکز API به‌روز است. برای مشاهده مرکز API باید به حساب مدیریت خود وارد شوید. بدون یک آدرس ایمیل معتبر و مرتباً بررسی‌شده، نمی‌توانید مراحل درخواست را تکمیل کنید. مطمئن شوید که تمام حساب‌های فعال Google Ads خود را با استفاده از توکن API به حساب مدیریت متصل کرده‌اید.
دسترسی استاندارد
سطح دسترسی استاندارد به توکن توسعه‌دهنده اجازه می‌دهد تا تعداد نامحدودی عملیات در روز را برای اکثر سرویس‌ها اجرا کند. این شامل GoogleAdsService Search و SearchStream می‌شود، اما محدود به آنها نیست. برای جزئیات بیشتر در مورد محدودیت‌ها و استثنائات سطح دسترسی استاندارد، به سهمیه‌های API مراجعه کنید.
سطح دسترسی استاندارد فقط به توسعه‌دهندگانی اعطا می‌شود که به عملیات نامحدود API تبلیغات گوگل نیاز دارند، مانند شرکت‌های بزرگ یا ابزارهایی که به کاربران زیادی خدمات ارائه می‌دهند.
صرف نظر از سطح دسترسی، تمام عملیات API مشمول محدودیت‌های نرخ سیستم هستند. برای کسب اطلاعات بیشتر در مورد نحوه مدیریت خطاهای محدودیت نرخ، به انواع خطا مراجعه کنید.
نحوه درخواست دسترسی استاندارد
اگر توکن توسعه‌دهنده با سطح دسترسی پایه دارید و می‌خواهید برای عملیات نامحدود API تبلیغات گوگل درخواست دهید، فرم درخواست دسترسی استاندارد را پر کنید .
اگر ابزار شما خارجی است، آماده باشید تا دسترسی ورود آزمایشی (دمو) به ابزار خود را فراهم کنید. توجه داشته باشید که ابزار شما باید با حداقل عملکرد مورد نیاز (Required Minimum Functionality) مطابقت داشته باشد.
استفاده مجاز
استفاده مجاز فقط برای توکن‌های توسعه‌دهندگان با سطوح دسترسی پایه و استاندارد اعمال می‌شود. استفاده مجاز بر اساس استفاده مورد نظر از API تبلیغات گوگل اختصاص داده می‌شود. این مجوزها تعیین می‌کنند که یک توکن توسعه‌دهنده برای کدام ویژگی‌های API قابل استفاده است، همانطور که در جدول زیر توضیح داده شده است:
| استفاده مجاز | توضیحات |
|---|---|
| ایجاد / مدیریت تبلیغات | دسترسی به تمام سرویس‌های API برای ایجاد و مدیریت کمپین‌های گوگل ادز، گروه‌های تبلیغاتی، تبلیغات و کلمات کلیدی را فراهم کنید. |
| گزارش‌دهی | فقط درخواست‌های GoogleAdsService.Search یا GoogleAdsService.SearchStream یا فراخوانی‌های فقط خواندنی را انجام دهید. این برای توسعه‌دهندگانی است که فقط از API برای درخواست آمار استفاده می‌کنند. |
| تحقیق در مورد کلمات کلیدی و توصیه‌ها | به توکن اجازه دسترسی به RecommendationService، KeywordPlanIdeaService و KeywordPlanService را بدهید. این فقط توسط ابزارهایی استفاده می‌شود که برای تسهیل ایجاد و مدیریت کمپین‌های گوگل ادز به پیشنهادها نیاز دارند. |
نحوه تغییر کاربری مجاز
اگر توکن توسعه‌دهنده شما برای سطح دسترسی پایه یا استاندارد تأیید شده است، می‌توانید فرم درخواست به‌روزرسانی استفاده مجاز را پر کنید. اگر می‌خواهید استفاده مجاز خود را به‌روزرسانی کنید یا به مشتریان خود دسترسی به ابزار خود را اعطا کنید، فرم درخواست را پر کنید.