API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
Search Ads 360 Reporting API از نسخه‌سازی معنایی استفاده می‌کند.
نسخه های اصلی و فرعی وجود دارد که به صورت v MAJOR _ MINOR فرمت شده اند. به عنوان مثال، v0_0 اولین نسخه اصلی و v0_1 اولین نسخه کوچک است. پسوند شماره نسخه نشان دهنده نوع نسخه است: برای نسخه های اصلی همیشه صفر است و برای نسخه های کوچک همیشه بزرگتر از صفر است.
نسخه های اصلی
نسخه های اصلی تغییرات شکسته ای را ایجاد می کنند، یعنی تغییراتی که با عقب سازگار نیستند.
هر نسخه اصلی یک نقطه پایان جداگانه دارد، به عنوان مثال:
هنگام ارتقاء از یک نسخه اصلی به نسخه دیگر، ممکن است لازم باشد قبل از تغییر به نقطه پایانی نسخه اصلی جدید، کد خود را تغییر دهید.
اگر از کتابخانه مشتری استفاده می کنید، باید به جدیدترین نسخه ارتقا دهید. نسخه‌های اصلی جدید یک راهنمای انتقال ارائه می‌کنند تا به شما در رفع هرگونه تغییر شکسته در کدتان کمک کند.
نمونه هایی از تغییرات شکسته عبارتند از:
حذف یا تغییر نام یک سرویس، رابط، فیلد، روش یا مقدار enum.
تغییر نوع فیلد
تغییر قالب نام منبع
تغییر فرمت URL در تعریف HTTP.
تغییر فرمت های خروجی، مانند تغییر 0 به -- به عنوان مقدار پیش فرض.
تغییر دلیل خطا از A به B برگردانده شد.
نسخه های کوچک
نسخه های کوچک فقط تغییرات سازگار با عقب را ارائه می دهند.
هنگامی که یک نسخه کوچک منتشر می شود، نقطه پایانی که از قبل در حال استفاده است به طور خودکار به روز می شود. این باعث نمی شود کد شما خراب شود. می توانید به استفاده از کتابخانه مشتری موجود خود ادامه دهید.
نسخه‌های کوچک شامل ویژگی‌ها یا به‌روزرسانی‌های جدیدی هستند که بر کد موجود شما تأثیری نمی‌گذارند. اگر می‌خواهید از ویژگی‌های جدید استفاده کنید، باید کتابخانه مشتری خود را به آخرین نسخه ارتقا دهید.
غروب
هنگامی که یک نسخه قدیمی‌تر Search Ads 360 Reporting API برای غروب برنامه‌ریزی شده است، ما اعلامیه‌ای را در گروه searchads-api-announcements Google پست می‌کنیم.
تاریخ آخرین بهروزرسانی 2024-11-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-11-24 بهوقت ساعت هماهنگ جهانی."],[[["The Search Ads 360 Reporting API uses semantic versioning with major and minor versions, where major versions introduce breaking changes and minor versions are backwards-compatible."],["Major version releases require code changes and utilize separate endpoints, while minor version releases automatically update the existing endpoint without breaking existing code."],["Breaking changes in major versions might involve removing or renaming elements, changing types or formats, or modifying outputs and error reasons."],["Minor versions bring new features or updates but do not affect existing code; to utilize new features, upgrade your client library."],["Sunset notices for older API versions are posted on the searchads-api-announcements Google group."]]],[]]
