به پروژه گوگل کلود شما یک سطح دسترسی و «استفاده مجاز» اختصاص داده شده است. سطح دسترسی تعیین میکند که آیا میتوانید روی حسابهای کاربری تولیدی و تعداد عملیات و درخواستهایی که میتوانید روزانه اجرا کنید، تأثیر بگذارید یا خیر. استفاده مجاز، ویژگیهای خاص API گوگل ادز را که پروژه مجاز به استفاده از آنها است، تعیین میکند.
سطوح دسترسی
چهار سطح دسترسی مختلف به API به ترتیب در جدول فهرست شدهاند. اگر از قبل به API تبلیغات گوگل دسترسی ندارید، میتوانید با فعال کردن API ، سطح دسترسی به حساب آزمایشی را برای پروژه Google Cloud خود دریافت کنید. میتوانید با انجام برخی مراحل اضافی در برنامه، سطح دسترسی را افزایش دهید.
| سطح دسترسی | امکان دسترسی ... | محدودیت کارکرد روزانه ۱ | چگونه درخواست دهیم | بررسیها معمولاً چقدر طول میکشد؟ |
|---|---|---|---|---|
| سطح دسترسی حساب آزمایشی | حسابهای آزمایشی | ۱۵۰۰۰ عملیات در روز | درخواست دسترسی آزمایشی به حساب کاربری | |
| سطح دسترسی اکسپلورر | حسابهای آزمایشی و تولیدی | ۲۸۸۰ عملیات در روز برای حسابهای تولید ۱۵۰۰۰ عملیات در روز برای حسابهای آزمایشی | درخواست دسترسی اکسپلورر | |
| سطح دسترسی پایه | حسابهای آزمایشی و تولیدی | ۱۵۰۰۰ عملیات در روز برای هر دو حساب آزمایشی و عملیاتی | درخواست دسترسی پایه | |
| سطح دسترسی استاندارد | حسابهای آزمایشی و تولیدی | عملیات نامحدود در روز برای حسابهای آزمایشی و عملیاتی | درخواست دسترسی استاندارد | ۱۰ روز کاری |
۱. «به ازای هر روز» بر اساس یک دوره زمانی متغیر ۲۴ ساعته است که در آن درخواستهای API با پروژه Google Cloud شما انجام شده است. اگر درخواست شما در ۲۴ ساعت گذشته از محدودیت درخواست برای سطح دسترسی شما فراتر رود، خطایی دریافت خواهد کرد.
سطح دسترسی حساب آزمایشی
پس از فعال کردن API تبلیغات گوگل، به پروژه گوگل کلود شما سطح دسترسی به حساب آزمایشی اعطا میشود. این بدان معناست که پروژه فقط میتواند درخواستهای API تبلیغات گوگل را برای حسابهای آزمایشی ارسال کند.
درخواست سطح دسترسی حساب آزمایشی
برای اینکه سطح دسترسی حساب آزمایشی (Test Account Access) برای پروژه شما به طور خودکار اعطا شود ، API تبلیغات گوگل (Google Ads API) را در پروژه گوگل کلود خود فعال کنید .
سطح دسترسی اکسپلورر
پس از تکمیل ثبت نام اولیه برای API تبلیغات گوگل، گوگل ممکن است به شما اجازه دهد برای سطح دسترسی اکسپلورر درخواست دهید.
سطح دسترسی اکسپلورر به پروژه گوگل کلود شما اجازه میدهد تا درخواستهای API گوگل ادز را هم برای حسابهای آزمایشی و هم برای حسابهای عملیاتی ارسال کند. حسابهای عملیاتی هر حسابی هستند که تبلیغات واقعی و زنده گوگل را ارائه میدهند - حسابهای آزمایشی تبلیغات را ارائه نمیدهند.
سطح دسترسی اکسپلورر به پروژه گوگل کلود شما اجازه میدهد تا روزانه تا ۲۸۸۰ عملیات را در حسابهای کاربری عملیاتی اجرا کند. این سطح برای اکثر توسعهدهندگان جهت شروع کار با API و ساخت اتوماسیون اولیه کافی است.
سطح دسترسی اکسپلورر، دسترسی به ویژگیهای زیر را محدود میکند. اگر نیاز به استفاده از این ویژگیها دارید، باید برای سطح دسترسی پایه یا سطح دسترسی استاندارد درخواست دهید.
| عملکرد محدود | خدمات و روشهای محدود |
|---|---|
| ایجاد حساب کاربری | CustomerService.CreateCustomerClient |
| مدیریت کاربران | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| برنامهریزی | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| صورتحساب و پرداخت حساب | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
درخواست سطح دسترسی اکسپلورر
- به صفحه مرور کلی API تبلیغات گوگل در پروژه گوگل کلود خود بروید.
- تأیید کنید که صفحه، سطح دسترسی فعلی شما را به صورت Test نمایش میدهد.
- برای گسترش بخش ارتقاء سطح دسترسی ، کلیک کنید.
- تأیید کنید که سطح دسترسی بعدی به عنوان Explorer نمایش داده شود.
- برای درخواست سطح دسترسی اکسپلورر، روی دکمه «درخواست دسترسی» کلیک کنید.
ممکن است گوگل پس از ارسال درخواست شما، به طور خودکار سطح دسترسی API پروژه شما را به سطح دسترسی Explorer ارتقا دهد.
سطح دسترسی پایه
سطح دسترسی پایه به پروژه گوگل کلود شما اجازه میدهد تا درخواستهای API گوگل ادز را هم برای حسابهای آزمایشی و هم برای حسابهای عملیاتی ارسال کند. حسابهای عملیاتی هر حسابی هستند که تبلیغات واقعی و زنده گوگل را ارائه میدهند - حسابهای آزمایشی تبلیغات را ارائه نمیدهند.
سطح دسترسی پایه به پروژه گوگل کلود شما اجازه میدهد تا روزانه تا ۱۵۰۰۰ عملیات انجام دهد. این برای اکثر توسعهدهندگان کافی است.
درخواست سطح دسترسی پایه
- به صفحه مرور کلی API تبلیغات گوگل در پروژه گوگل کلود خود بروید.
- تأیید کنید که صفحه، سطح دسترسی فعلی شما را به عنوان Explorer نمایش میدهد.
- برای گسترش بخش ارتقاء سطح دسترسی ، کلیک کنید.
- تأیید کنید که سطح دسترسی بعدی به صورت Basic نمایش داده شود.
- مطمئن شوید که هیچ هشداری مبنی بر عدم تکمیل تأیید برند برای پروژه شما وجود ندارد. در صورت وجود، قبل از ادامه، دستورالعملهای تکمیل تأیید برند را دنبال کنید .
- برای درخواست سطح دسترسی پایه، روی دکمه «درخواست دسترسی» کلیک کنید.
ممکن است گوگل به طور خودکار سطح دسترسی API پروژه شما را پس از ارسال درخواستتان به سطح دسترسی پایه ارتقا دهد.
سطح دسترسی استاندارد
سطح دسترسی استاندارد به پروژه گوگل کلود شما اجازه میدهد تا تعداد نامحدودی عملیات در روز را برای همه سرویسها اجرا کند. سرویسها و ویژگیهای خاص ممکن است همچنان محدودیتهای نرخ و محدودیتهایی داشته باشند که مختص آن ویژگیها هستند، که حتی اگر پروژه شما دارای سطح دسترسی استاندارد باشد، همچنان اعمال خواهند شد.
سطح دسترسی استاندارد فقط به توسعهدهندگانی اعطا میشود که به عملیات نامحدود API تبلیغات گوگل نیاز دارند، مانند شرکتهای بزرگ یا ابزارهایی که به کاربران زیادی خدمات ارائه میدهند.
درخواست سطح دسترسی استاندارد
- به صفحه مرور کلی API تبلیغات گوگل در پروژه گوگل کلود خود بروید.
- تأیید کنید که صفحه، سطح دسترسی فعلی شما را به صورت Basic نمایش میدهد.
- برای گسترش بخش ارتقاء سطح دسترسی ، کلیک کنید.
- تأیید کنید که سطح دسترسی بعدی به صورت استاندارد نمایش داده شود.
- برای شروع برنامه با سطح دسترسی استاندارد، روی دکمه شروع برنامه کلیک کنید.
برنامه دسترسی استاندارد شامل یک ممیزی دستی دقیق از برنامه شما است. آماده باشید تا به سؤالات مربوط به عملکرد ابزار خود و مخاطبان هدف آن پاسخ دهید. اگر ابزار شما توسط کاربران خارجی استفاده میشود، آماده باشید تا دسترسی ورود آزمایشی به ابزار خود را ارائه دهید. توجه داشته باشید که ابزار شما باید با حداقل عملکرد مورد نیاز مطابقت داشته باشد.
در طول فرآیند بررسی، تیم انطباق گوگل از طریق آدرس ایمیل شما با شما ارتباط برقرار خواهد کرد. اطمینان حاصل کنید که به سرعت به سوالات تیم انطباق پاسخ میدهید تا روند درخواست دسترسی استاندارد شما پیشرفت کند. پس از اتمام بررسی، گوگل نتیجه نهایی فرآیند بررسی را برای شما ایمیل خواهد کرد.
سهمیههای API و محدودیتهای نرخ سیستم
صرف نظر از سطح دسترسی، تمام عملیات API مشمول محدودیتهای سرعت سیستم هستند که تعداد عملیات مجاز برای انجام در یک دوره زمانی، یعنی تعداد عملیات در ساعت، را محدود میکند. برای کسب اطلاعات بیشتر در مورد نحوه مدیریت خطاهای محدودیت سرعت، به بخش انواع خطا مراجعه کنید.
سرویسهای منفرد ممکن است به دلایلی مانند محدودیتهای طراحی محصول، محدودیتهای سیاست محصول، عملکرد API و ملاحظات تأخیر، محدودیتها و سهمیهبندیهای اضافی اعمال کنند. برای کسب اطلاعات بیشتر در مورد این محدودیتها، به مستندات مربوط به سهمیهبندی API مراجعه کنید.
استفاده مجاز
استفاده مجاز فقط برای پروژههای Google Cloud با سطوح دسترسی استاندارد اعمال میشود. استفاده مجاز بر اساس استفاده مورد نظر از API تبلیغات گوگل اختصاص داده میشود. این مجوزها تعیین میکنند که ابزار شما از کدام ویژگیهای API میتواند استفاده کند، همانطور که در جدول زیر توضیح داده شده است:
| استفاده مجاز | توضیحات |
|---|---|
| ایجاد / مدیریت تبلیغات | دسترسی به تمام سرویسهای API برای ایجاد و مدیریت کمپینهای گوگل ادز، گروههای تبلیغاتی، تبلیغات و کلمات کلیدی را فراهم کنید. |
| گزارشدهی | فقط درخواستهای GoogleAdsService.Search یا GoogleAdsService.SearchStream یا فراخوانیهای فقط خواندنی را انجام دهید. این برای توسعهدهندگانی است که فقط از API برای درخواست آمار استفاده میکنند. |
| تحقیق در مورد کلمات کلیدی و توصیهها | به پروژه Google Cloud اجازه دهید به RecommendationService ، KeywordPlanIdeaService و KeywordPlanService دسترسی داشته باشد. این فقط توسط ابزارهایی استفاده میشود که برای تسهیل ایجاد و مدیریت کمپینهای Google Ads به پیشنهادات نیاز دارند. |
تغییر کاربری مجاز
اگر پروژه گوگل کلود شما برای سطح دسترسی استاندارد تأیید شده است، میتوانید فرم درخواست بهروزرسانی استفاده مجاز را پر کنید. اگر میخواهید استفاده مجاز خود را بهروزرسانی کنید یا به مشتریان خود دسترسی به ابزار خود را اعطا کنید، فرم درخواست را پر کنید.