پنجشنبه، ۲۷ فوریه ۲۰۲۵
درحال معرفی چندین تغییر در روشCustomerService.CreateCustomerClient هستیم تا Google Ads API را با نحوه مدیریت عملکرد ایجاد حساب جدید در واسط کاربر Google Ads هماهنگ کنیم. این تغییرات در ۱۷ مارس ۲۰۲۵ اعمال خواهد شد.کدهای خطای جدید برای اجرای خط‌مشی
برای محدود کردن سوءاستفاده، Google Ads API دو کد خطای جدید در نسخه v19 از API برای اجرای خط‌مشی معرفی کرده است.
- حساب‌های مدیر Google Ads که آستانه مشخصی از هزینه یا تعداد مشخصی حساب فرعی فعال بدون مشکل خط‌مشی (برای مثال، به‌دلیل نقض خط‌مشی تعلیق یا بسته نشده باشند) نداشته باشند، واجدشرایط ایجاد حساب فرعی تحت حساب خود نخواهند بود. توسعه‌دهندگان در نسخه v19 آتی Google Ads API کد خطای
CustomerError.CREATION_DENIED_INELIGIBLE_MCCرا دریافت خواهند کرد. برای رفع مشکل، حساب Google Ads را پیوند دهید که با خط‌مشی‌های Google مطابقت داشته باشد و سطوح آستانه هزینه را تحت حساب مدیر شما برآورده کند. - حساب‌های مدیر Google Ads که به‌دلیل نقض خط‌مشی‌های مربوط به ایجاد حساب پرچم‌گذاری شده‌اند، دیگر نمی‌توانند حساب‌های فرعی تحت مدیریت خود ایجاد کنند. توسعه‌دهندگان در نسخه v19 آتی Google Ads API کد خطای
CustomerError.CREATION_DENIED_FOR_POLICY_VIOLATIONرا دریافت خواهند کرد.
در هر دو مورد، نسخه‌های موجود میانای برنامه‌سازی کاربردی (v18 و قدیمی‌تر) به‌جای آن خطای ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT را نشان خواهند داد.
محدودیت‌های سهمیه برای ایجاد حساب
Google Ads API محدودیت‌هایی را برای ایجاد حساب‌های Google Ads جدید اعمال خواهد کرد. توسعه‌دهندگان پس‌از رسیدن به حد مجاز، خطای QuotaError.RESOURCE_EXHAUSTED را دریافت خواهند کرد. فیلد retry_delay از quota_error_details حاوی جزئیات بیشتری درباره مدت زمانی است که باید قبل‌از امتحان مجدد فراخوانی API صبر کنید. انتظار نداریم اکثر توسعه‌دهندگان تحت تأثیر این محدودیت‌ها قرار بگیرند.
چه کاری باید انجام دهم؟
اگر برنامه شما از Google Ads API برای ایجاد حساب‌های Google Ads جدید استفاده می‌کند، باید کد خود را بررسی کنید تا مطمئن شوید که برنامه شما این کدهای خطای جدید را به‌درستی مدیریت می‌کند.
اگر سؤالی دارید یا به راهنمایی نیاز دارید، گزینه‌های موجود در صفحه پشتیبانی Google Ads API را بررسی کنید.برای هرگونه سؤال مربوط به خط‌مشی‌های حساب، با تیم پشتیبانی محصول Google Ads تماس بگیرید.
- Anash P. Oommen، تیم Google Ads API
برچسب‌ها: authentication، google-ads-api، oauth