اعتبارًا من 8 سبتمبر 2025، يجب أن يحدّد كل عنصر جديد في الحملة ما إذا كان سيعرض إعلانات سياسية في الاتحاد الأوروبي أم لا. ستتعذّر عمليات تحميل واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" وملفات SDF التي لا تقدّم بيانات الإفصاح. يمكنك الاطّلاع على صفحة الإيقاف النهائي لمزيد من التفاصيل حول كيفية تعديل عملية الدمج لإجراء هذا البيان.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تاريخ آخر تعديل: 2025-07-31
نقل تطبيقك
يتطلّب النقل من الإصدار 3 إلى الإصدار 4 تعديل عناوين URL لنقاط النهاية من أجل طلب الإصدار 4، وتعديل تطبيقك لتضمين التغييرات غير المتوافقة مع الإصدارات السابقة.
تعديل طلبات البيانات من واجهة برمجة التطبيقات من الإصدار 3 إلى الإصدار 4
لاستخدام الإصدار 4 بدلاً من الإصدار 3، عدِّل طلباتك لاستخدام نقاط نهاية الإصدار 4 الجديدة.
على سبيل المثال، لطلب بيانات من طريقة advertisers.get باستخدام الإصدار 3، استخدِم عنوان URL التالي:
GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId
بالنسبة إلى الإصدار 4، عدِّل عنوان URL إلى ما يلي:
GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId
إذا كنت تستخدم مكتبة برامج للعميل لإرسال طلبات إلى واجهة برمجة التطبيقات، استخدِم أحدث إصدار من مكتبة برامج العميل وعدِّل إعداداتك لاستخدام الإصدار 4.
إجراء التغييرات المطلوبة
نحن بصدد طرح عدد من التغييرات التي قد تؤدي إلى أعطال في الإصدار 4. راجِع التعليمات التالية وأجرِ التغييرات المطلوبة ذات الصلة باستخدامك الحالي لواجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360".
تعديل المكالمات المتعلّقة بمراجع الجمهور التابعة للطرف الأوّل والتابعة لجهات خارجية والاستهداف ذي الصلة
تم استبدال موارد FirstAndThirdPartyAudience بموارد FirstPartyAndPartnerAudience.
تاريخ التعديل الأخير: 2025-07-31 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],["To migrate to v4, update endpoint URLs to v4 and adjust for breaking changes. `FirstAndThirdPartyAudience` resources are replaced by `FirstPartyAndPartnerAudience`. `advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions` is now `bulkListAssignedTargetingOptions`. `optimizationObjective` is required in `InsertionOrder` resource creation. Remove all requests for campaign or insertion order targeting. Also, remove all references to the `publisherReviewStatuses` field in the `Creative` resource. Finally update `FirstAndThirdPartyAudienceType` and `AudienceType` references.\n"],null,["# Migrate from v3 to v4\n\n*Last update: 2025-07-31*\n\nMigrate your application\n------------------------\n\nMigrating from v3 to v4 requires updating your endpoint URLs to call v4 and\nupdating your application to account for breaking changes.\n\n### Update your API calls from v3 to v4\n\nTo use v4 instead of v3, update your requests to use new v4 endpoints.\n\nFor example, to call the [`advertisers.get`](/display-video/api/reference/rest/v4/advertisers/get) method with v3, use the\nfollowing URL: \n\n GET https://displayvideo.googleapis.com/v3/advertisers/\u003cvar translate=\"no\"\u003eadvertiserId\u003c/var\u003e\n\nFor v4, update the URL to the following: \n\n GET https://displayvideo.googleapis.com/v4/advertisers/\u003cvar translate=\"no\"\u003eadvertiserId\u003c/var\u003e\n\nIf you are using a client library to make requests to the API, use the most\nrecent version of the client library and update your configuration to use v4.\n\n### Make required changes\n\nWe're introducing a number of breaking changes in v4. Review the following\ninstructions and make the required changes relevant to your existing use of the\nDisplay \\& Video 360 API.\n\n#### Update calls regarding first- and third-party audience resources and related targeting\n\n`FirstAndThirdPartyAudience` resources have been replaced by\n`FirstPartyAndPartnerAudience` resources.\n\nThis change requires you to update the following:\n\n- References to `FirstAndThirdPartyAudience` resources to use the new [`FirstPartyAndPartnerAudience`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience) resource.\n- Existing requests to methods in the v3 service `firstAndThirdPartyAudiences` to the new v4 service [`firstPartyAndPartnerAudiences`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#methods).\n- Expectations of the default page size for [`firstPartyAndPartnerAudiences.list`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences/list) requests from 100 to 5000 items.\n- References to the v3 `firstAndThirdPartyAudienceType` field to the new v4 [`firstPartyAndPartnerAudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudience.FIELDS.first_party_and_partner_audience_type) field, using the new [`FirstPartyAndPartnerAudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#FirstPartyAndPartnerAudienceType) enum type, with old values corresponding to the following new values:\n - `FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY` to `TYPE_FIRST_PARTY`\n - `FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY` to `TYPE_PARTNER`\n- References to [`AudienceType`](/display-video/api/reference/rest/v4/firstPartyAndPartnerAudiences#AudienceType) enum value `LICENSED` to instead use\n one of the following new, more specific values:\n\n - `THIRD_PARTY`\n - `COMMERCE`\n - `LINEAR`\n- References to [`AssignedTargetingOption`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption) resources of\n [`TargetingType`](/display-video/api/reference/rest/v4/TargetingType) `TARGETING_TYPE_AUDIENCE_GROUP` to replace\n the v3 fields in\n [`AudienceGroupAssignedTargetingOptionDetails`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails) with\n the following new v4 fields:\n\n - `excludedFirstAndThirdPartyAudienceGroup` with [`excludedFirstPartyAndPartnerAudienceGroup`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails.FIELDS.excluded_first_party_and_partner_audience_group)\n - `includedFirstAndThirdPartyAudienceGroups` with [`includedFirstPartyAndPartnerAudienceGroups`](/display-video/api/reference/rest/v4/advertisers.adGroups.targetingTypes.assignedTargetingOptions#AssignedTargetingOption.AudienceGroupAssignedTargetingOptionDetails.FIELDS.included_first_party_and_partner_audience_groups)\n\n#### Update existing ad group bulk list targeting requests\n\n`advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions` has been renamed\n[`advertisers.adGroups.bulkListAssignedTargetingOptions`](/display-video/api/reference/rest/v4/advertisers.adGroups/bulkListAssignedTargetingOptions).\nUpdate your existing requests to use the new method name.\n\n#### Include an optimization objective when creating insertion orders\n\n[`optimizationObjective`](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder.FIELDS.optimization_objective) is now a required field in the\n[`InsertionOrder`](/display-video/api/reference/rest/v4/advertisers.insertionOrders#InsertionOrder) resource. Update your\n[`advertisers.insertionOrders.create`](/display-video/api/reference/rest/v4/advertisers.insertionOrders/create) requests to verify that this\nfield is set.\n\n#### Remove references to the creative resource field `publisherReviewStatuses`\n\nThe `publisherReviewStatuses` field has been removed from the\n[`ReviewStatusInfo`](/display-video/api/reference/rest/v4/advertisers.creatives#ReviewStatusInfo) object under the\n[`Creative`](/display-video/api/reference/rest/v4/advertisers.creatives#Creative) resource after being [deprecated in June\n2024](/display-video/api/deprecations#features.creative_publisher_review_statuses)."]]
