البقاء على اطّلاع على آخر الأخبار في Google Ads API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتغيّر Google Ads API بشكل متكرّر، وعليك الحرص على تحديث تطبيقك باستمرار
ليتضمّن التغييرات.
إصدارات واجهات برمجة التطبيقات وإيقافها نهائيًا
عادةً ما تتضمّن Google Ads API ثلاثة إصدارات رئيسية وثلاث عمليات إيقاف نهائي للإصدارات الرئيسية كل عام. يتم الحفاظ على ثلاثة إصدارات رئيسية في أي وقت، ويتم إيقاف الإصدارات الأقدم مع كل إصدار رئيسي جديد. عليك بذل جهد لتحديث تطبيقك بانتظام. يمكنك الاطّلاع على سياسة الإصدار لمعرفة المزيد.
يمكنك الاطّلاع على مصفوفة إصدارات مكتبة البرامج وإصدارات واجهة برمجة التطبيقات المتوافقة على الصفحة الرئيسية لمكتبة البرامج. بالنسبة إلى مكتبة برامج Python، يتوفّر مصفوفة تبعية أكثر تفصيلاً.
الميزات التي سيتم إيقافها نهائيًا
على الرغم من أنّ Google Ads API تحاول مواءمة أكبر عدد ممكن من التغييرات غير المتوافقة في الميزات مع حدود الإصدارات، لا يكون ذلك ممكنًا دائمًا. في الحالات التي لا يمكن فيها
مواءمة التغييرات غير المتوافقة مع حدود الإصدارات، تجري Google Ads API تغييرات غير مرتبطة بإصدار.
يتم الإعلان عن التغييرات غير المرتبطة بإصدار على مدوّنة واجهة برمجة التطبيقات الرسمية، ويتم تلخيصها في صفحة الإيقاف النهائي. إذا كان هذا التغيير يؤثّر في طلبات البيانات من واجهة برمجة التطبيقات أو الحسابات التي تديرها، قد ترسل إليك Google إشعارًا إلزاميًا عن الخدمة عبر البريد الإلكتروني يتضمّن ملخّصًا للتغيير. يُرجى التأكّد من إبقاء عنوان البريد الإلكتروني الخاص بجهة الاتصال المعنيّة بواجهة برمجة التطبيقات محدّثًا حتى تتمكّن من تلقّي هذه الرسائل الإلكترونية. بالإضافة إلى ذلك، يمكنك متابعة المدوّنة الرسمية للاطّلاع على أي إشعارات.
إعلانات مهمة
يتم الإعلان عن جميع التغييرات المتعلّقة بواجهة Google Ads API في المدوّنة الرسمية.
ننصحك بمتابعة المدوّنة لمعرفة المزيد عن التغييرات القادمة.
يتم الإعلان عن التغييرات المتعلّقة بمنتج "إعلانات Google" على مدونة المنتج الرسمية. بالإضافة إلى مدونة واجهة برمجة التطبيقات، عليك متابعة مدونة المنتج لضمان عدم تفويت أي تغييرات وإشعارات بشأن المنتج.
يتم توضيح جميع التغييرات المتعلّقة بإصدار معيّن من واجهة برمجة التطبيقات في ملاحظات الإصدار. إذا كان لديك ملف شخصي لمطوِّر على Google، يمكنك حفظ صفحة ملاحظات الإصدار في ملفك الشخصي وتلقّي إشعارات عند تعديل الصفحة أو بشكل دوري. يتم أيضًا الإعلان عن الإصدارات الفردية في مدوّنتنا الرسمية.
يمكنك متابعة هاتين الصفحتين لمعرفة المزيد عن الميزات الجديدة في Google Ads API.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-05 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Ads API has frequent updates, including three major releases and sunsets annually, requiring you to keep your application current.\u003c/p\u003e\n"],["\u003cp\u003eUnversioned changes and feature deprecations are communicated through the API blog, sunset page, and potentially Mandatory Service Announcement emails, so ensure your contact information is up-to-date.\u003c/p\u003e\n"],["\u003cp\u003eStay informed about API changes and new features by following the official API blog and release notes, and consider saving the release notes page in your Google Developer Profile for update notifications.\u003c/p\u003e\n"],["\u003cp\u003eKeep track of the Google Ads product blog to remain aware of product changes and announcements that may affect your API usage.\u003c/p\u003e\n"]]],[],null,["# Stay updated with the Google Ads API\n\nThe Google Ads API changes frequently, and you should keep your application up to date\nwith the changes.\n\nAPI releases and sunsets\n------------------------\n\nThe Google Ads API usually has three major releases and three major release sunsets per\nyear. Three major releases are actively maintained at any one time, and the\nearlier versions are sunset with each new major release. You should invest\neffort to regularly upgrade your application. See our [release policy](/google-ads/api/docs/sunset-dates) to\nlearn more.\n\nThe matrix of client library versions and supported API versions can be found on\nthe [client library home page](/google-ads/api/docs/client-libs#supported_api_versions). For the Python client library, there is a\nmore [detailed dependency matrix](/google-ads/api/docs/client-libs/python/dependencies).\n\nFeature deprecations\n--------------------\n\nWhile the Google Ads API tries to align as many incompatible feature changes to version\nboundaries, this isn't always possible. In cases where it isn't possible to\nalign incompatible changes to version boundaries, the Google Ads API makes unversioned\nchanges.\n\nUnversioned changes are announced on the official [API blog](//ads-developers.googleblog.com/) and\nsummarized on the [sunset page](/google-ads/api/docs/sunset-dates). If this change affects your API calls or\nthe accounts that you manage, Google may send you a Mandatory Service\nAnnouncement email summarizing the change. Make sure you [keep your API contact\nemail updated](/google-ads/api/docs/productionize/shared-aliases#contact_email), so that you can receive these emails. In addition, follow\nthe official blog for any announcements.\n\nAnnouncements\n-------------\n\nAll changes related to the Google Ads API are announced on the [official blog](//ads-developers.googleblog.com/).\nYou should keep track of the blog to learn more about upcoming changes.\n\nChanges related to the Google Ads product are announced on the [official product\nblog](//blog.google/products/ads-commerce/). In addition to the API blog, you should follow the product blog to\nensure that you don't miss product changes and announcements.\n\nAll the changes related to a specific API release are explained in our [release\nnotes](/google-ads/api/docs/release-notes). If you have a [Google Developer Profile](/profile/help/overview), you can\n[save](/profile/help/saved-pages#receive_notifications) the release notes page in your profile and\n[receive notifications](/profile/help/saved-pages#save_a_page) when the page is updated, or on a periodic\nbasis. Individual releases are also announced on our [official blog](//ads-developers.googleblog.com/).\nKeep track of both these pages to learn more about new features in the Google Ads API."]]
