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

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

رفتن به نمای کلی Google Ads API در کنسول Cloud

سطوح دسترسی

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

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

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

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

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

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

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 Ads API» در پروژه Google Cloud خود بروید.
  2. بررسی کنید که صفحه سطح دسترسی فعلی شما را به‌صورت آزمایشی نمایش دهد.
  3. برای ازهم بازکردن بخش ارتقا دادن سطح دسترسی کلیک کنید.
  4. تأیید کنید که سطح دسترسی بعدی به‌صورت کاوشگر نمایش داده می‌شود.
  5. روی دکمه درخواست دسترسی کلیک کنید تا برای سطح دسترسی «کاوشگر» درخواست دهید.

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

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

سطح دسترسی «پایه» به پروژه 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 Ads API» در پروژه Google Cloud خود بروید.
  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 شما برای سطح دسترسی «استاندارد» تأیید شده است، می‌توانید درخواست به‌روزرسانی کاربرد مجاز را تکمیل کنید. اگر می‌خواهید استفاده مجازتان را به‌روز کنید یا به مشتریانتان اجازه دسترسی به ابزارتان را بدهید، درخواست را تکمیل کنید.

قبلی
کد توسعه‌دهنده
بعدی
درستی‌سنجی نمانام