آزمایش، گامی مهم در ساخت یک ادغام موفق با Google Ads API است، چه تازه شروع به کار کرده باشید، چه در حال نگهداری یک برنامه باشید و چه ویژگی‌های جدیدی را به یک ادغام موجود اضافه کنید. این راهنما برخی از بهترین شیوه‌ها را برای آزمایش ادغام Google Ads API شما ارائه می‌دهد.
حساب‌های آزمایشی و حساب‌های تولیدی
حساب‌های آزمایشی برای اهداف توسعه در دسترس هستند. با حساب‌های آزمایشی، می‌توانید تأیید کنید که کد برنامه و پیکربندی شما طبق برنامه کار می‌کنند.
با این حال، همه ویژگی‌ها را نمی‌توان در یک حساب آزمایشی آزمایش کرد.
وقتی محدودیت‌های حساب آزمایشی مانع از آزمایش برخی از ویژگی‌ها در یکپارچه‌سازی شما می‌شود، می‌توانید از یک حساب تولیدی برای توسعه استفاده کنید. حساب‌های تولیدی برای توسعه از جهات زیر با حساب‌های آزمایشی متفاوت هستند:
- تبلیغاتی را ارائه دهید که توسط کاربران قابل مشاهده باشد
- به URL های معتبر نیاز دارید
- باید از قوانین تبلیغات پیروی کند
از آنجا که حساب‌های کاربری تولید، تبلیغات را ارائه می‌دهند، معیارهایی ایجاد می‌کنند که به شما امکان می‌دهد گزارش‌های عملکرد را آزمایش کنید و همچنین از سایر ویژگی‌های API تبلیغات گوگل بهره‌مند شوید. با این حال، استفاده از آنها برای توسعه نیاز به احتیاط بیشتری دارد. توصیه می‌کنیم اقدامات زیر را انجام دهید:
- فقط به کاربرانی که برای اهداف توسعه به آن نیاز دارند، دسترسی بدهید.
- یک بودجه حساب کاربری روزانه ثابت و کم تعیین کنید.
- فقط زمانی که نمی‌توان از حساب‌های آزمایشی استفاده کرد، از حساب‌های عملیاتی برای توسعه استفاده کنید.
بنابراین، برای انجام آزمایش کامل یکپارچه‌سازی خود، احتمالاً به هر دو اعتبارنامه‌ی آزمایشی و اعتبارنامه‌ی عملیاتی نیاز خواهید داشت.
اعتبارنامه‌های آزمون
برای به حداقل رساندن خطر تغییر تصادفی حساب‌های کاربری در محیط عملیاتی هنگام تلاش برای تغییر حساب‌های کاربری توسعه، توصیه می‌کنیم مجموعه‌ای از اعتبارنامه‌های آزمایشی را که جدا از اعتبارنامه‌های برنامه کاربردی عملیاتی شما هستند، نگهداری کنید.
برای ایجاد مجموعه‌ای از اعتبارنامه‌های آزمایشی:
- یک حساب ایمیل (مثلاً api.test@example.com) یا یک حساب سرویس که فقط برای اهداف آزمایشی استفاده خواهد شد، ایجاد کنید.
- این حساب کاربری یا سرویس را به عنوان یک کاربر معتبر در حساب‌های گوگل ادز که تست‌های خود را روی آنها اجرا می‌کنید، اضافه کنید. مطمئن شوید که سطوح دسترسی مناسبی به این حساب کاربری یا سرویس می‌دهید. به این حساب کاربری یا سرویس، دسترسی به هیچ حساب کاربری دیگری ندهید.
- اگر از جریان احراز هویت کاربر OAuth 2.0 به جای جریان حساب سرویس استفاده می‌کنید، یک توکن به‌روزرسانی برای حساب کاربری آزمایشی خود ایجاد کنید.
- هنگام آزمایش برنامه خود از این اعتبارنامه‌های جدید استفاده کنید. توکن توسعه‌دهنده، شناسه کلاینت و رمز کلاینت را می‌توان برای اهداف آزمایشی دوباره استفاده کرد، زیرا آنها هیچ تاثیری در تعیین اینکه کدام حساب‌های Google Ads قابل دسترسی هستند، ندارند.
درخواست اعتبارسنجی
اگر فقط نیاز دارید که اعتبار یک درخواست را بررسی کنید - مثلاً برای تأیید اینکه درخواست به درستی ساختار یافته است و خط‌مشی‌ها را نقض نمی‌کند - می‌توانید از فیلد validate_only استفاده کنید که برای درخواست‌های GoogleAdsService.SearchStream و GoogleAdsService.Search و همچنین اکثر درخواست‌های mutate در دسترس است. برای تأیید اینکه آیا این فیلد برای یک روش خاص در دسترس است یا خیر، به مستندات مرجع مراجعه کنید.
API رست
برای آزمایش موردی، به عنوان مثال برای تأیید اینکه یک درخواست خروجی مورد انتظار را ارائه می‌دهد، استفاده از REST API اغلب ساده‌ترین گزینه است. برای یادگیری نحوه استفاده از curl در ارسال درخواست به REST API، به مثال‌های REST مراجعه کنید. همچنین، آزمایش را در REST explorer امتحان کنید.