سطوح دسترسی و استفاده مجاز

به هر توکن توسعه‌دهنده API تبلیغات گوگل یک سطح دسترسی و «استفاده مجاز» اختصاص داده شده است. سطح دسترسی تعیین می‌کند که آیا می‌توانید روی حساب‌های تولید و تعداد عملیات و درخواست‌هایی که می‌توانید روزانه اجرا کنید، تأثیر بگذارید یا خیر. استفاده مجاز، ویژگی‌های خاص API تبلیغات گوگل را که توکن توسعه‌دهنده مجاز به استفاده از آنها است، تعیین می‌کند.

سطوح دسترسی

چهار سطح دسترسی مختلف برای توکن توسعه‌دهندگان به ترتیب در جدول فهرست شده‌اند. اگر از قبل به API تبلیغات گوگل دسترسی ندارید، می‌توانید با ثبت‌نام برای دریافت توکن توسعه‌دهندگان با سطح دسترسی حساب آزمایشی شروع کنید. می‌توانید با انجام برخی مراحل اضافی در برنامه، سطح دسترسی را افزایش دهید.

^۱. «در هر روز» بر اساس یک دوره زمانی متغیر ۲۴ ساعته است که در آن درخواست‌های API با توکن توسعه‌دهنده شما انجام شده است. اگر درخواست شما در ۲۴ ساعت گذشته از محدودیت درخواست برای سطح دسترسی شما فراتر رود، خطایی دریافت خواهد کرد.

سطح دسترسی حساب آزمایشی

پس از تکمیل ثبت نام اولیه برای API تبلیغات گوگل، یک توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی به شما داده می‌شود. این بدان معناست که توکن توسعه‌دهنده فقط می‌تواند درخواست‌های API تبلیغات گوگل را برای حساب‌های آزمایشی ارسال کند.

نحوه درخواست سطح دسترسی حساب آزمایشی

برای اینکه به طور خودکار سطح دسترسی آزمایشی به حساب کاربری به شما اعطا شود ، ثبت نام API گوگل ادز را در رابط وب گوگل ادز تکمیل کنید.

سطح دسترسی اکسپلورر

پس از تکمیل ثبت نام اولیه برای API تبلیغات گوگل، گوگل ممکن است در برخی موارد به طور خودکار توکن توسعه‌دهنده شما را از سطح دسترسی حساب آزمایشی به سطح دسترسی اکسپلورر ارتقا دهد. سطح دسترسی اکسپلورر به توکن توسعه‌دهنده اجازه می‌دهد تا درخواست‌های API تبلیغات گوگل را هم برای حساب‌های آزمایشی و هم برای حساب‌های تولیدی ارسال کند. حساب‌های تولیدی هر حسابی هستند که تبلیغات واقعی و زنده گوگل را ارائه می‌دهند - حساب‌های آزمایشی تبلیغات را ارائه نمی‌دهند.

سطح دسترسی اکسپلورر به توکن توسعه‌دهنده اجازه می‌دهد تا روزانه تا ۲۸۸۰ عملیات را در حساب‌های کاربری عملیاتی اجرا کند. این مقدار برای اکثر توسعه‌دهندگان جهت شروع کار با API و ساخت اتوماسیون اولیه کافی است.

سطح دسترسی اکسپلورر، دسترسی به ویژگی‌های زیر را محدود می‌کند. اگر نیاز به استفاده از این ویژگی‌ها دارید، باید برای سطح دسترسی پایه یا سطح دسترسی استاندارد درخواست دهید.

نحوه درخواست برای سطح دسترسی اکسپلورر

ثبت نام API گوگل ادز را در رابط وب گوگل ادز تکمیل کنید. در برخی موارد، ممکن است گوگل به طور خودکار پس از تکمیل ثبت نام، توکن توسعه‌دهنده شما را به سطح دسترسی اکسپلورر ارتقا دهد.

سطح دسترسی پایه

سطح دسترسی پایه به توکن توسعه‌دهنده اجازه می‌دهد تا درخواست‌های API تبلیغات گوگل را هم برای حساب‌های آزمایشی و هم برای حساب‌های عملیاتی ارسال کند. حساب‌های عملیاتی هر حسابی هستند که تبلیغات واقعی و زنده گوگل را ارائه می‌دهند - حساب‌های آزمایشی تبلیغات را ارائه نمی‌دهند.

سطح دسترسی پایه به توکن توسعه‌دهنده اجازه می‌دهد تا روزانه تا ۱۵۰۰۰ عملیات انجام دهد. این برای اکثر توسعه‌دهندگان کافی است.

نحوه درخواست برای سطح دسترسی پایه

اگر توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی دارید و می‌خواهید برای دسترسی به حساب کاربری در مرحله تولید درخواست دهید، فرم درخواست سطح دسترسی پایه را پر کنید . مطمئن شوید که این مراحل را انجام داده‌اید:

1. مطمئن شوید که از قبل یک توکن توسعه‌دهنده با سطح دسترسی حساب آزمایشی دارید.
2. مطمئن شوید که ایمیل تماس API در مرکز API به‌روز است. برای مشاهده مرکز API باید به حساب مدیریت تبلیغات گوگل خود وارد شوید. بدون یک آدرس ایمیل معتبر و مرتباً بررسی‌شده، نمی‌توانید مراحل درخواست را تکمیل کنید. مطمئن شوید که تمام حساب‌های فعال تبلیغات گوگل خود را با استفاده از توکن API به حساب مدیریت تبلیغات گوگل متصل کرده‌اید.

سطح دسترسی استاندارد

سطح دسترسی استاندارد به توکن توسعه‌دهنده اجازه می‌دهد تا تعداد نامحدودی عملیات در روز را برای اکثر سرویس‌ها اجرا کند. این شامل GoogleAdsService Search و SearchStream می‌شود، اما محدود به آنها نیست. برای جزئیات بیشتر در مورد محدودیت‌ها و استثنائات سطح دسترسی استاندارد، به سهمیه‌های API مراجعه کنید.

سطح دسترسی استاندارد فقط به توسعه‌دهندگانی اعطا می‌شود که به عملیات نامحدود API تبلیغات گوگل نیاز دارند، مانند شرکت‌های بزرگ یا ابزارهایی که به کاربران زیادی خدمات ارائه می‌دهند.

نحوه درخواست برای سطح دسترسی استاندارد

اگر توکن توسعه‌دهنده با سطح دسترسی پایه دارید و می‌خواهید برای عملیات نامحدود API تبلیغات گوگل درخواست دهید، فرم درخواست سطح دسترسی استاندارد را پر کنید .

اگر ابزار شما خارجی است، آماده باشید تا دسترسی ورود آزمایشی (دمو) به ابزار خود را فراهم کنید. توجه داشته باشید که ابزار شما باید با حداقل عملکرد مورد نیاز (Required Minimum Functionality) مطابقت داشته باشد.

سهمیه‌های API و محدودیت‌های نرخ سیستم

صرف نظر از سطح دسترسی، تمام عملیات API مشمول محدودیت‌های سرعت سیستم هستند که تعداد عملیات مجاز برای انجام در یک دوره زمانی، یعنی تعداد عملیات در ساعت، را محدود می‌کند. برای کسب اطلاعات بیشتر در مورد نحوه مدیریت خطاهای محدودیت سرعت، به بخش انواع خطا مراجعه کنید.

سرویس‌های منفرد ممکن است به دلایلی مانند محدودیت‌های طراحی محصول، محدودیت‌های سیاست محصول، عملکرد API و ملاحظات تأخیر، محدودیت‌ها و سهمیه‌بندی‌های اضافی اعمال کنند. برای کسب اطلاعات بیشتر در مورد این محدودیت‌ها، به مستندات مربوط به سهمیه‌بندی API مراجعه کنید.

استفاده مجاز

استفاده مجاز فقط برای توکن‌های توسعه‌دهندگان با سطوح دسترسی پایه و استاندارد اعمال می‌شود. استفاده مجاز بر اساس استفاده مورد نظر از API تبلیغات گوگل اختصاص داده می‌شود. این مجوزها تعیین می‌کنند که یک توکن توسعه‌دهنده برای کدام ویژگی‌های API قابل استفاده است، همانطور که در جدول زیر توضیح داده شده است:

نحوه تغییر کاربری مجاز

اگر توکن توسعه‌دهنده شما برای سطح دسترسی پایه یا سطح دسترسی استاندارد تأیید شده است، می‌توانید فرم درخواست به‌روزرسانی استفاده مجاز را پر کنید. اگر می‌خواهید استفاده مجاز خود را به‌روزرسانی کنید یا به مشتریان خود دسترسی به ابزار خود را اعطا کنید، فرم درخواست را پر کنید.