آزمایش کردن گام مهمی در ساختن ادغام موفق 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 explorer آزمایش کنید.