از نسخه 3 به نسخه 4 مهاجرت کنید

آخرین به روز رسانی: 2025-07-31

درخواست خود را مهاجرت کنید

انتقال از نسخه 3 به نسخه 4 مستلزم به روز رسانی URL های نقطه پایانی خود برای فراخوانی نسخه 4 و به روز رسانی برنامه خود برای ایجاد حساب برای تغییرات شکسته است.

تماس های API خود را از نسخه 3 به نسخه 4 به روز کنید

برای استفاده از v4 به جای v3، درخواست های خود را برای استفاده از نقاط پایانی جدید v4 به روز کنید.

به عنوان مثال، برای فراخوانی متد advertisers.get با v3، از URL زیر استفاده کنید:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

برای نسخه 4، URL را به موارد زیر به روز کنید:

GET https://displayvideo.googleapis.com/v4/advertisers/advertiserId

اگر از کتابخانه سرویس گیرنده برای درخواست به API استفاده می کنید، از جدیدترین نسخه کتابخانه مشتری استفاده کنید و پیکربندی خود را برای استفاده از v4 به روز کنید.

تغییرات لازم را انجام دهید

ما در حال معرفی تعدادی از تغییرات شکسته در نسخه 4 هستیم. دستورالعمل‌های زیر را مرور کنید و تغییرات مورد نیاز مربوط به استفاده فعلی خود از Display & Video 360 API را انجام دهید.

تماس‌های مربوط به منابع مخاطبان شخص اول و ثالث و هدف‌یابی مرتبط را به‌روزرسانی کنید

منابع FirstAndThirdPartyAudience با منابع FirstPartyAndPartnerAudience جایگزین شده اند.

این تغییر نیازمند به روز رسانی موارد زیر است:

• ارجاع به منابع FirstAndThirdPartyAudience برای استفاده از منبع FirstPartyAndPartnerAudience جدید.
• درخواست‌های موجود به روش‌های موجود در سرویس v3 firstAndThirdPartyAudiences به سرویس جدید v4 firstPartyAndPartnerAudiences .
• انتظارات اندازه صفحه پیش فرض برای درخواست های firstPartyAndPartnerAudiences.list از 100 تا 5000 مورد.
• ارجاع به فیلد v3 firstAndThirdPartyAudienceType به قسمت جدید v4 firstPartyAndPartnerAudienceType ، با استفاده از نوع enum FirstPartyAndPartnerAudienceType جدید، با مقادیر قدیمی مربوط به مقادیر جدید زیر:
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY به TYPE_FIRST_PARTY
  • FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY به TYPE_PARTNER

• ارجاع به AudienceType مقدار enum LICENSED به جای استفاده از یکی از مقادیر جدید و خاص زیر:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• ارجاع به منابع AssignedTargetingOption از TargetingType TARGETING_TYPE_AUDIENCE_GROUP برای جایگزینی فیلدهای v3 در AudienceGroupAssignedTargetingOptionDetails با فیلدهای v4 جدید زیر:

  • excludedFirstAndThirdPartyAudienceGroup با excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups با includedFirstPartyAndPartnerAudienceGroups

درخواست‌های هدف‌یابی فهرست انبوه گروه تبلیغات موجود را به‌روزرسانی کنید

advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions به advertisers.adGroups.bulkListAssignedTargetingOptions تغییر نام داده است. درخواست های موجود خود را برای استفاده از نام روش جدید به روز کنید.

هنگام ایجاد دستورهای درج، هدف بهینه سازی را درج کنید

optimizationObjective اکنون یک فیلد ضروری در منبع InsertionOrder است. درخواست‌های advertisers.insertionOrders.create خود را به‌روزرسانی کنید تا تأیید کنید که این فیلد تنظیم شده است.

ارجاعات به حوزه منبع خلاق publisherReviewStatuses حذف کنید

پس از منسوخ شدن در ژوئن 2024، قسمت publisherReviewStatuses از شی ReviewStatusInfo در زیر منبع Creative حذف شده است.