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