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

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

سطوح دسترسی

چهار سطح دسترسی مختلف به API در جدول به‌ترتیب فهرست شده است. اگر ازقبل به Google Ads API دسترسی ندارید، می‌توانید با فعال کردن API برای دریافت سطح دسترسی «آزمایشی» برای پروژه Google Cloud خود شروع کنید. با تکمیل چند مرحله دیگر در برنامه می‌توانید سطح دسترسی را افزایش دهید.

سطح دسترسی	می‌تواند به این موارد دسترسی داشته باشد…	حد عملیات روزانه ۱	نحوه درخواست دادن	بازبینی‌ها معمولاً چقدر طول می‌کشند؟
آزمایش	حساب‌های آزمایشی	‫۱۵٬۰۰۰ عملیات در روز	درخواست دسترسی آزمایشی
کاوشگر	حساب‌های آزمایشی و تولید	‫۲٬۸۸۰ عملیات در روز برای حساب‌های تولید ۱۵٬۰۰۰ عملیات در روز برای حساب‌های آزمایشی	درخواست دسترسی به Explorer
اولیه	حساب‌های آزمایشی و تولیدی	‫۱۵٬۰۰۰ عملیات / روز برای هر دو حساب آزمایشی و تولید	درخواست دسترسی پایه
استاندارد	حساب‌های آزمایشی و تولید	عملیات نامحدود در روز برای هر دو حساب آزمایشی و تولید	درخواست دسترسی استاندارد	‫۱۰ روز کاری

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

دسترسی آزمایشی

پس‌از فعال کردن Google Ads API، پروژه Google Cloud شما دسترسی «آزمایشی» دریافت می‌کند. این یعنی پروژه فقط می‌تواند درخواست‌های «میانای برنامه‌سازی کاربردی Google Ads» را دربرابر حساب‌های آزمایشی انجام دهد.

درخواست دسترسی آزمایشی

Google Ads API را در پروژه Google Cloud خود فعال کنید تا به‌طور خودکار دسترسی آزمایشی برای پروژه شما اعطا شود.

سطح دسترسی کاوشگر

پس‌از تکمیل ثبت‌نام اولیه برای Google Ads API، ممکن است Google به شما اجازه دهد برای سطح دسترسی «کاوشگر» درخواست دهید.

سطح دسترسی «کاوشگر» به پروژه Google Cloud شما اجازه می‌دهد درخواست‌های Google Ads API را هم برای حساب‌های آزمایشی و هم برای حساب‌های تولیدی ارسال کند. حساب‌های تولید هر حسابی است که آگهی‌های واقعی و زنده Google را ارائه می‌دهد—حساب‌های آزمایشی آگهی ارائه نمی‌دهند.

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

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

عملکرد محدودشده	سرویس‌ها و روش‌های محدودشده
ایجاد کردن حساب	CustomerService.CreateCustomerClient
مدیریت کاربر	CustomerUserAccessInvitationService CustomerUserAccessService
برنامه‌ریزی	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService ReachPlanService
صدور صورت‌حساب و پرداخت حساب	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

درخواست برای سطح دسترسی «کاوشگر»

1. در پروژه Google Cloud خود، به صفحه «نمای کلی میانای برنامه‌سازی کاربردی Google Ads» پیمایش کنید.
2. بررسی کنید که صفحه سطح دسترسی فعلی شما را به‌صورت آزمایشی نمایش دهد.
3. برای ازهم بازکردن بخش ارتقا دادن سطح دسترسی کلیک کنید.
4. تأیید کنید که سطح دسترسی بعدی به‌عنوان کاوشگر نمایش داده می‌شود.
5. روی دکمه درخواست دسترسی کلیک کنید تا برای سطح دسترسی «کاوشگر» درخواست دهید.

‫Google ممکن است پس‌از ارسال درخواستتان، سطح دسترسی API پروژه شما را به‌طور خودکار به «کاوشگر» ارتقا دهد.

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

سطح دسترسی «پایه» به پروژه Google Cloud شما اجازه می‌دهد تا درخواست‌های Google Ads API را هم دربرابر حساب‌های آزمایشی و هم دربرابر حساب‌های تولید انجام دهد. حساب‌های تولید عبارت‌اند از حساب‌هایی که تبلیغات Google واقعی و زنده ارائه می‌دهند—حساب‌های آزمایشی تبلیغات ارائه نمی‌دهند.

سطح دسترسی «پایه» به پروژه Google Cloud شما اجازه می‌دهد تا ۱۵٬۰۰۰ عملیات در روز اجرا کند. این گزینه برای اکثر توسعه‌دهندگان کافی است.

درخواست سطح دسترسی «پایه»

1. به صفحه «نمای کلی Google Ads API» در پروژه Google Cloud خود بروید.
2. تأیید کنید که صفحه سطح دسترسی فعلی شما را به‌عنوان کاوشگر نمایش می‌دهد.
3. برای ازهم بازکردن بخش ارتقا دادن سطح دسترسی کلیک کنید.
4. تأیید کنید که سطح دسترسی بعدی به‌صورت پایه نمایش داده می‌شود.
5. تأیید کنید که هیچ هشداری مبنی بر عدم تکمیل درستی‌سنجی نمانام برای پروژه شما وجود ندارد. اگر وجود دارد، دستورالعمل‌ها را دنبال کنید تا درستی‌سنجی نمانام را قبل‌از ادامه دادن تکمیل کنید.
6. روی دکمه درخواست دسترسی کلیک کنید تا برای سطح دسترسی «پایه» درخواست دهید.

Google ممکن است پس‌از ارسال درخواستتان، سطح دسترسی میانای برنامه‌سازی کاربردی پروژه‌تان را به‌طور خودکار به «پایه» ارتقا دهد.

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

سطح دسترسی استاندارد به پروژه Google Cloud شما اجازه می‌دهد تعداد نامحدودی عملیات در روز برای همه سرویس‌ها اجرا کند. سرویس‌ها و ویژگی‌های تکی ممکن است همچنان دارای محدودیت‌های نرخ و محدودیت‌های خاصی باشند که مختص آن ویژگی‌ها است و حتی اگر پروژه شما سطح دسترسی استاندارد داشته باشد، همچنان اعمال خواهند شد.

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

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

1. در پروژه Google Cloud خود، به صفحه «نمای کلی میانای برنامه‌سازی کاربردی Google Ads» پیمایش کنید.
2. بررسی کنید که صفحه سطح دسترسی فعلی شما را پایه نشان دهد.
3. برای ازهم بازکردن بخش ارتقا دادن سطح دسترسی کلیک کنید.
4. تأیید کنید که سطح دسترسی بعدی به‌صورت استاندارد نمایش داده می‌شود.
5. برای شروع درخواست سطح دسترسی «استاندارد»، روی دکمه شروع درخواست کلیک کنید.

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

درطول فرایند بازبینی، تیم «رعایت مقررات Google» ازطریق نشانی ایمیلتان با شما ارتباط برقرار خواهد کرد. مطمئن شوید که به پرسش‌های تیم «رعایت مقررات» به‌موقع پاسخ می‌دهید تا درخواست دسترسی «استاندارد» شما پیشرفت کند. وقتی بازبینی تکمیل شد، Google نتیجه نهایی فرایند بازبینی را ازطریق ایمیل به شما اطلاع خواهد داد.

سهمیه‌های میانای برنامه‌سازی کاربردی و حدود نرخ سیستم

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

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

استفاده مجاز

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

استفاده مجاز	شرح
ساختن / مدیریت آگهی	دسترسی به همه سرویس‌های API برای ایجاد و مدیریت کمپین‌های Google Ads، گروه‌های آگهی، آگهی‌ها، و کلیدواژه‌ها را فراهم می‌کند.
گزارش	فقط درخواست‌های GoogleAdsService.Search یا GoogleAdsService.SearchStream یا تماس‌های فقط خواندنی برقرار کنید. این برای توسعه‌دهندگانی است که فقط از API برای درخواست آمار استفاده می‌کنند.
پژوهش درباره کلیدواژه‌ها و توصیه‌ها	به پروژه Google Cloud اجازه دهید به RecommendationService،‏ KeywordPlanIdeaService، و KeywordPlanService دسترسی داشته باشد. این فقط توسط ابزارهایی استفاده می‌شود که برای کمک به تسهیل ایجاد و مدیریت پویش‌های Google Ads به پیشنهاد نیاز دارند.

تغییر استفاده مجاز

اگر پروژه Google Cloud شما برای سطح دسترسی «استاندارد» تأیید شده است، می‌توانید درخواست به‌روزرسانی استفاده مجاز را تکمیل کنید. اگر می‌خواهید استفاده مجاز خود را به‌روز کنید یا به مشتریانتان اجازه دهید به ابزارتان دسترسی داشته باشند، درخواست را تکمیل کنید.