با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نسخه سازی معنایی
Google Ads API از نسخه‌سازی معنایی پیروی می‌کند که در آن نسخه اصلی و فرعی وجود دارد. قالب نسخه MAJOR.MINOR یا vMAJOR_MINOR است. به عنوان مثال، v21_0 یک نسخه اصلی است، در حالی که v21_1 یک نسخه کوچک است.
نسخه‌های اصلی منتشر شده، برخی تغییرات ناسازگار و ناسازگار را ارائه می‌کنند. نسخه با فرمت vX_0 به صفر ختم می‌شود که X شماره نسخه اصلی است.
هر نسخه اصلی یک نقطه پایان جداگانه دارد. در این URL مثال، X شماره نسخه اصلی است.
https://googleads.googleapis.com/vX
اگر در حال ارتقاء از یک نسخه اصلی قدیمی هستید، ممکن است وقتی به نقطه پایانی نسخه اصلی جدید بروید، کد شما نیاز به تغییرات داشته باشد. اگر از کتابخانه های مشتری ما استفاده می کنید، به جدیدترین نسخه ارتقا دهید. هنگامی که یک نسخه اصلی منتشر شد، ما یک راهنمای انتقال ارائه می کنیم که باید برای رفع هرگونه تغییر شکسته در کد خود از آن استفاده کنید.
نمونه هایی از تغییرات شکسته عبارتند از:
حذف یا تغییر نام یک سرویس، رابط، فیلد، روش یا مقدار enum.
تغییر نوع فیلد
تغییر قالب نام منبع
تغییر فرمت URL در تعریف HTTP.
تغییر فرمت های خروجی مانند تغییر از 0 به -- به عنوان مقدار پیش فرض.
تغییر دلیل خطا از A به B برگردانده شد.
نسخه های کوچک
نسخه های کوچک فقط تغییرات سازگار با عقب را معرفی می کنند. برای یک نسخه کوچک، vMAJOR_MINOR یک عدد MINOR بزرگتر از صفر خواهد داشت.
هنگامی که یک نسخه کوچک منتشر می شود، نقطه پایانی که از قبل در حال استفاده است به طور خودکار به روز می شود. این باعث نمی شود کد شما شکسته شود. می توانید به استفاده از کتابخانه های مشتری موجود خود ادامه دهید.
نسخه‌های کوچک شامل ویژگی‌ها یا به‌روزرسانی‌های جدیدی هستند که بر کد موجود شما تأثیری نمی‌گذارند. اگر می‌خواهید از این ویژگی‌های جدید استفاده کنید، کتابخانه‌های مشتری خود را به جدیدترین نسخه ارتقا دهید.
غروب
به‌طور دوره‌ای، نسخه‌های قدیمی‌تر API Google Ads باید غروب کنند. زمانی که یک نسخه در آستانه غروب آفتاب باشد، اعلامیه‌هایی را در وبلاگ توسعه‌دهنده پست می‌کنیم. برنامه منسوخ شدن با تاریخ های غروب آفتاب آینده به روز می شود.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Ads API uses semantic versioning with major and minor versions, impacting how updates are handled.\u003c/p\u003e\n"],["\u003cp\u003eMajor version updates introduce breaking changes, requiring code modifications and endpoint URL changes to \u003ccode\u003ehttps://googleads.googleapis.com/vX\u003c/code\u003e, where 'X' represents the major version number.\u003c/p\u003e\n"],["\u003cp\u003eMinor version updates are backwards compatible, automatically applied to the existing endpoint, and primarily introduce new features.\u003c/p\u003e\n"],["\u003cp\u003eOlder API versions are periodically sunset; refer to the developer blog and deprecation schedule for announcements and timelines.\u003c/p\u003e\n"]]],[],null,["# Versioning\n\n| **Objective:** Learn how Google Ads API versioning works.\n\nSemantic versioning\n-------------------\n\nThe Google Ads API follows [semantic versioning](https://semver.org/) where there is a\na major and a minor version. The format of the version is `MAJOR.MINOR` or\n`vMAJOR_MINOR`. For example, `v21_0` is a major version, while\n`v21_1` is a minor version.\n\nSee the [release notes](/google-ads/api/docs/release-notes) for past versions.\n\n### Major versions\n\nMajor release versions introduce some breaking, backwards incompatible changes.\nThe version would end in zero with the format `vX_0` where `X` is the major\nversion number.\n\nEach major version has a separate endpoint. In this example URL, `X` is the\nmajor version number. \n\n https://googleads.googleapis.com/vX\n\nIf you are upgrading from an older major version, then your code may require\nchanges when you switch to the new major version endpoint. If you are using our\n[client libraries](/google-ads/api/docs/client-libs), then upgrade to the newest version.\nWhen there is a major version released, we will provide a migration guide that\nyou should go through to fix any breaking changes in your code.\n\nExamples of breaking changes include:\n\n- Removing or renaming a service, interface, field, method or enum value.\n- Changing the type of a field.\n- Changing a resource name format.\n- Changing the URL format in the HTTP definition.\n- Changing output formats such as changing from `0` to `--` as default value.\n- Changing the error reason returned from A to B.\n\n### Minor versions\n\nMinor versions only introduce backward-compatible changes. For a minor version,\n`vMAJOR_MINOR` would have a `MINOR` number greater than zero.\n\nWhen a minor version is released, the endpoint that is already in use will\nautomatically be updated. This won't cause your code to break. You can\ncontinue to use your existing client libraries.\n\nMinor versions include new features or updates that don't affect your\nexisting code. If you want to use these new features, then upgrade your\n[client libraries](/google-ads/api/docs/client-libs) to the newest version.\n\nSunsets\n-------\n\nPeriodically, older Google Ads API versions will need to sunset. We will post notices\non the [developer blog](//ads-developers.googleblog.com/search/label/google_ads_api)\nwhen a version is about to sunset. The\n[deprecation schedule](/google-ads/api/docs/sunset-dates) is updated with future sunset\ndates."]]
