קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ניהול גרסאות סמנטי
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.
גרסאות משניות
בגרסאות משניות מוצגים רק שינויים שתואמים לגרסאות קודמות. בגרסה משנית,�0x0A>vMAJOR_MINOR יהיה מספר MINOR גדול מאפס.
כשגרסה משנית יוצאת, נקודת הקצה שכבר נמצאת בשימוש מתעדכנת אוטומטית. הפעולה הזו לא תגרום לקוד שלכם להפסיק לפעול. אתם יכולים להמשיך להשתמש בספריות הלקוח הקיימות.
גרסאות משניות כוללות תכונות חדשות או עדכונים שלא משפיעים על הקוד הקיים. כדי להשתמש בתכונות החדשות האלה, צריך לשדרג את ספריות הלקוח לגרסה העדכנית.
שקיעה
מעת לעת, גרסאות ישנות יותר של Google Ads API יוצאות משימוש. נפרסם הודעות בבלוג למפתחים כשגרסה מסוימת עומדת לצאת משימוש. לוח הזמנים להוצאה משימוש מתעדכן עם תאריכי הוצאה משימוש עתידיים.
[[["התוכן קל להבנה","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-05 (שעון UTC)."],[[["\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."]]
