نسخه سازی معنایی
Google Ads API از نسخه‌سازی معنایی پیروی می‌کند که در آن نسخه اصلی و فرعی وجود دارد. قالب نسخه MAJOR.MINOR یا vMAJOR_MINOR است. به عنوان مثال، v18_0 یک نسخه اصلی است، در حالی که v18_1 یک نسخه کوچک است.
یادداشت های انتشار نسخه های گذشته را ببینید.
نسخه های اصلی
نسخه‌های اصلی منتشر شده، برخی تغییرات ناسازگار و ناسازگار را ارائه می‌کنند. نسخه با فرمت vX_0 به صفر ختم می‌شود که X شماره نسخه اصلی است.
هر نسخه اصلی یک نقطه پایان جداگانه دارد. این نمونه ای از URL است که در آن X شماره نسخه اصلی است.
https://googleads.googleapis.com/vX
اگر در حال ارتقاء از یک نسخه اصلی قدیمی هستید، ممکن است وقتی به نقطه پایانی نسخه اصلی جدید بروید، کد شما نیاز به تغییرات داشته باشد. اگر از کتابخانه های مشتری ما استفاده می کنید، به جدیدترین نسخه ارتقا دهید. هنگامی که یک نسخه اصلی منتشر شد، ما یک راهنمای انتقال ارائه می کنیم که باید برای رفع هرگونه تغییر شکسته در کد خود از آن استفاده کنید.
نمونه هایی از تغییرات شکسته عبارتند از:
- حذف یا تغییر نام یک سرویس، رابط، فیلد، روش یا مقدار enum.
- تغییر نوع فیلد
- تغییر قالب نام منبع
- تغییر فرمت URL در تعریف HTTP.
- تغییر فرمت های خروجی مانند تغییر از
0به--به عنوان مقدار پیش فرض. - تغییر دلیل خطا از A به B برگردانده شد.
نسخه های کوچک
نسخه های کوچک فقط تغییرات سازگار با عقب را معرفی می کنند. برای یک نسخه کوچک، vMAJOR_MINOR یک عدد MINOR بزرگتر از صفر خواهد داشت.
هنگامی که یک نسخه کوچک منتشر می شود، نقطه پایانی که از قبل در حال استفاده است به طور خودکار به روز می شود. این باعث نمی شود کد شما شکسته شود. می توانید به استفاده از کتابخانه های مشتری موجود خود ادامه دهید.
نسخه‌های کوچک شامل ویژگی‌ها یا به‌روزرسانی‌های جدیدی هستند که بر کد موجود شما تأثیری نمی‌گذارند. اگر می‌خواهید از این ویژگی‌های جدید استفاده کنید، کتابخانه‌های مشتری خود را به جدیدترین نسخه ارتقا دهید.
غروب
به‌طور دوره‌ای، نسخه‌های قدیمی‌تر API Google Ads باید غروب کنند. زمانی که یک نسخه در آستانه غروب آفتاب باشد، اعلامیه‌هایی را در وبلاگ توسعه‌دهنده پست می‌کنیم. برنامه منسوخ شدن با تاریخ های غروب آفتاب آینده به روز می شود.