تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الترقيم الدلالي للإصدارات
تتّبع Google Ads API الترقيم الدلالي للإصدارات، حيث يتوفّر إصدار رئيسي وإصدار ثانوي. يكون تنسيق الإصدار MAJOR.MINOR أو vMAJOR_MINOR. على سبيل المثال، v21_0 هو إصدار رئيسي، بينما v21_1 هو إصدار ثانوي.
تتضمّن إصدارات الإصدارات الرئيسية بعض التغييرات التي لا تتوافق مع الإصدارات السابقة.
سينتهي رقم الإصدار بصفر بالتنسيق vX_0 حيث X هو رقم الإصدار الرئيسي.
يحتوي كل إصدار رئيسي على نقطة نهاية منفصلة. في مثال عنوان URL هذا، X هو رقم الإصدار الرئيسي.
https://googleads.googleapis.com/vX
إذا كنت بصدد الترقية من إصدار رئيسي قديم، قد يتطلّب الرمز إجراء تغييرات عند التبديل إلى نقطة نهاية الإصدار الرئيسي الجديد. إذا كنت تستخدم
مكتبات برامجنا، عليك الترقية إلى أحدث إصدار.
عند إصدار نسخة رئيسية، سنقدّم دليل نقل بيانات يجب الاطّلاع عليه لإصلاح أي تغييرات غير متوافقة في الرمز.
تشمل الأمثلة على التغييرات غير المتوافقة ما يلي:
إزالة أو إعادة تسمية خدمة أو واجهة أو حقل أو طريقة أو قيمة تعداد
تغيير نوع حقل
تغيير تنسيق اسم مورد
تغيير تنسيق عنوان URL في تعريف HTTP
تغيير تنسيقات الإخراج، مثل التغيير من 0 إلى -- كقيمة تلقائية
تغيير سبب الخطأ الذي يتم عرضه من A إلى B
الإصدارات الثانوية
لا تتضمّن الإصدارات الثانوية سوى تغييرات متوافقة مع الأنظمة القديمة. بالنسبة إلى إصدار ثانوي،
سيكون للرقم vMAJOR_MINOR قيمة MINOR أكبر من صفر.
عند إصدار نسخة ثانوية، سيتم تعديل نقطة النهاية المستخدَمة تلقائيًا. لن يؤدي ذلك إلى تعطُّل الرمز. يمكنك مواصلة استخدام مكتبات البرامج الحالية.
تتضمّن الإصدارات الثانوية ميزات جديدة أو تحديثات لا تؤثّر في الرمز الحالي. إذا أردت استخدام هذه الميزات الجديدة، عليك ترقية
مكتبات البرامج إلى أحدث إصدار.
صور غروب الشمس
سنضطر إلى إيقاف إصدارات Google Ads API القديمة نهائيًا بشكل دوري. سننشر إشعارات
على مدوّنة المطوّرين
عندما يوشك أحد الإصدارات على إيقافه نهائيًا. يتم تعديل
جدول الإيقاف النهائي ليشمل تواريخ الإيقاف النهائي المستقبلية.
تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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."]]
