آزمایش کردن گام مهمی در ساختن ادغام موفق Google Ads API است، خواه تازه شروع کرده باشید، درحال نگهداری از برنامه باشید، یا ویژگی‌های جدیدی به ادغام موجود اضافه کنید. این راهنما برخی‌از روال‌های مطلوب را برای آزمایش کردن ادغام Google Ads API ارائه می‌دهد.
حساب‌های آزمایشی و حساب‌های تولید
حساب‌های آزمایشی برای اهداف توسعه دردسترس هستند. با حساب‌های آزمایشی می‌توانید تأیید کنید که کد و پیکربندی برنامه‌تان به‌درستی کار می‌کند.
اما همه ویژگی‌ها را نمی‌توان در حساب آزمایشی آزمایش کرد.
وقتی محدودیت‌های حساب آزمایشی مانع از آزمایش برخی ویژگی‌ها در ادغام شما می‌شود، می‌توانید به‌جای آن از حساب تولید برای توسعه استفاده کنید. پروژه Google Cloud شما باید حداقل سطح دسترسی Explorer (Explorer، Basic، یا Standard) را داشته باشد تا بتواند حساب تولید را فراخوانی کند. توجه داشته باشید که دسترسی «کاوشگر» همچنان برخی‌از سرویس‌ها را محدود می‌کند، ازجمله صورت‌حساب (BillingSetupService و AccountBudgetProposalService)، برنامه‌ریزی، ایجاد حساب، و دعوت از کاربران (به محدودیت‌های ویژگی کاوشگر مراجعه کنید) که به دسترسی «پایه» یا «استاندارد» نیاز دارند. تلاش برای فراخوانی حساب تولید از
پروژه‌ای با سطح دسترسی «آزمایشی»
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
را از v25، یا
AuthorizationError.ACTION_NOT_PERMITTED را در v24 و
قبل‌از آن برمی‌گرداند.
حساب‌های تولید برای توسعه از حساب‌های آزمایشی به روش‌های زیر متفاوت هستند:
- ارائه آگهی‌هایی که کاربران می‌توانند ببینند
- نشانی‌های وب معتبر الزامی است
- باید با خط‌مشی‌های تبلیغات مطابقت داشته باشد
چون حساب‌های تولید آگهی ارائه می‌دهند، سنجه‌هایی تولید می‌کنند که به شما امکان می‌دهد گزارش‌های عملکرد را آزمایش کنید و همچنین قفل همه ویژگی‌های دیگر Google Ads API را باز کنید. بااین‌حال، استفاده از آن‌ها برای توسعه نیازمند احتیاط بیشتری است. توصیه می‌کنیم اقدامات زیر را انجام دهید:
- فقط به کاربرانی که برای اهداف توسعه به آن نیاز دارند دسترسی اعطا کنید.
- بودجه حساب روزانه ثابت و پایینی تنظیم کنید.
- فقط زمانی از حساب‌های تولید برای توسعه استفاده کنید که نتوان از حساب‌های آزمایشی استفاده کرد.
بنابراین، برای آزمایش کامل ادغام، احتمالاً به هر دو اعتبارنامه آزمایشی و اعتبارنامه تولید نیاز خواهید داشت.
اطلاعات اعتباری آزمایشی
برای به‌حداقل رساندن خطر تغییر تصادفی حساب‌های تولید هنگام تلاش برای تغییر حساب‌های توسعه، توصیه می‌کنیم مجموعه‌ای از اطلاعات کاربری آزمایشی را که از اطلاعات کاربری برنامه تولید شما جدا هستند، حفظ کنید.
برای ایجاد مجموعه‌ای از اطلاعات کاربری آزمایشی، این مراحل را دنبال کنید:
- حساب ایمیلی (برای مثال،
api.test@example.com) یا حساب سرویسی ایجاد کنید که فقط برای اهداف آزمایشی استفاده خواهد شد. - این کاربر یا حساب سرویس را به‌عنوان کاربر معتبر در حساب‌های Google Ads که آزمایش‌هایتان را در آن‌ها اجرا می‌کنید اضافه کنید. مطمئن شوید که سطوح دسترسی مناسبی به این کاربر یا حساب سرویس می‌دهید. به این کاربر یا حساب سرویس اجازه دسترسی به هیچ حساب تولیدی را ندهید.
- اگر از جریان اصالت‌سنجی کاربر OAuth 2.0 به‌جای جریان حساب سرویس استفاده می‌کنید، یک ژتون بازآوری برای حساب کاربری آزمایشی خود ایجاد کنید.
- هنگام آزمایش کردن برنامه‌تان، از این اطلاعات کاربری جدید استفاده کنید. شناسه کارخواه و رمز کارخواه را می‌توان برای اهداف آزمایشی مجدداً استفاده کرد، زیرا تأثیری در تعیین اینکه به کدام حساب‌های Google Ads می‌توان دسترسی داشت ندارند. همه اطلاعات اعتباری و ژتون‌های بازآوری را به‌طور ایمن ذخیره کنید و هرگز آن‌ها را به کنترل منبع ارسال نکنید.
درخواست اعتبارسنجی
اگر فقط می‌خواهید معتبر بودن درخواست را آزمایش کنید (مثلاً برای درستی‌سنجی
اینکه درخواست به‌درستی ساختاربندی شده است و خط‌مشی‌ها را نقض نمی‌کند)،
می‌توانید از فیلد validate_only استفاده کنید که برای
درخواست‌های GoogleAdsService.Search دردسترس است (توجه داشته باشید که
GoogleAdsService.SearchStream از
validate_only) و اکثر درخواست‌های تغییر پشتیبانی نمی‌کند. برای تأیید اینکه آیا این فیلد برای روش خاصی دردسترس است یا نه، به اسناد مرجع مراجعه کنید.
REST API
برای آزمایش موردی، مثلاً برای اعتبارسنجی اینکه درخواست خروجی موردانتظار را تولید می‌کند، استفاده از REST API اغلب ساده‌ترین گزینه است. برای آشنایی با نحوه استفاده از curl در درخواست‌های REST API، به نمونه‌های REST مراجعه کنید. همچنین، آزمایش کردن در کاوشگر REST را امتحان کنید.