نقل البيانات من "قراءة الملفات" للكيانات

تم إيقاف ميزة "قراءة الملفات في الكيان" نهائيًا.

ملفات قراءة العناصر (ERF) هي تمثيلات بتنسيق JSON لعناصر حملة الشريك التي يتم توفيرها من خلال Google Cloud Storage.

تم إيقاف ERF نهائيًا في حزيران (يونيو) 2021، وسيتم إيقافه نهائيًا في 31 تشرين الأول (أكتوبر) 2024. لم يعُد يتم إنشاء تقارير ERF. استخدِم Display & Video 360 API لاسترداد موارد "مساحة العرض والفيديو 360".

يتناول هذا الدليل كيفية نقل البيانات من "ملفّات قراءة العناصر" إلى واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"، وذلك من خلال:

• تقديم نظرة عامة على الاختلافات بين الواجهات
• مقارنة جداول ERF بخدمات واجهة برمجة التطبيقات
• تقديم إرشادات حول استرداد الكيانات من خلال واجهة برمجة التطبيقات
• الاعتراف بالثغرات الحالية في البيانات
• عرض تعيين لجميع حقول ERF إلى حقول موارد واجهة برمجة التطبيقات المشابهة

نظرة عامة

عند نقل البيانات من ERF إلى واجهة برمجة التطبيقات "مساحة العرض والفيديو 360"، هناك عدد من الاختلافات الرئيسية التي يجب مراعاتها، بما في ذلك:

• حداثة البيانات: يتم إنشاء ERF يوميًا وبشكلٍ مجمّع، بينما تحصل واجهة برمجة التطبيقات على أحدث إصدار من المورد.
• بنية الموارد: تستخدم واجهة برمجة التطبيقات هياكل JSON مختلفة عن ERF لتمثيل أنواع الموارد نفسها. قد تستخدِم بعض الموارد، مثل إعدادات الاستهداف العام، مساحة تعريف مختلفة.
• طريقة الاسترداد: لا تتيح واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" استرداد موارد بشكلٍ فردي إلا في قوائم مفصّلة أو من خلال عمليات نقل بيانات BigQuery، على عكس ملفات JSON الأوّلية التي تقدّمها ERF.
• النطاق: على عكس ERFs التي يتم تحديد نطاقها حسب رقم تعريف الشريك، يتم تحديد نطاق معظم موارد API حسب رقم تعريف المعلِن. تقتصر المراجع المضمّنة في الردود على المراجع ضمن هذا النطاق.

تمثيل بيانات ERF في واجهة برمجة التطبيقات

يتم تقسيم ملفات قراءة الكيانات إلى جدولَين "عام" و "خاص". توفر الجداول العامة المعلومات المتاحة والقابلة للتطبيق على جميع المستخدمين، مثل قيم الاستهداف. توفر الجداول الخاصة بيانات خاصة بالشريك، مثل موارد المواد الإبداعية أو موارد العناصر.

ولا تستخدم واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" هذا التقسيم الثنائي، بل تجعل كل هذه المعلومات قابلة للاسترداد من خلال خدمات مختلفة وباستخدام بنى JSON مختلفة. يقارن هذا القسم المعلومات المقدَّمة من خلال جداول ERF العامة والخاصة بتلك المتاحة من خلال موارد ومقدّمات خدمات واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360".

المعلومات المتاحة للجميع

توفّر جداول ERF العامة مواد مرجعية للمستخدمين لاستخدامها عند تفسير إعدادات الاستهداف لمواردهم الخاصة التي تم استرجاعها وتخصيص الاستهداف من خلال مجموعة فرعية من إصدارات ملفّات البيانات المنظَّمة (SDF) التي تم تحميلها من خلال واجهة المستخدِم. هذه المواد المرجعية متماثلة لجميع المستخدمين وتتألف من معرّف رقمي يُستخدَم للربط وتفاصيل أكثر وصفية، مثل الاسم المعروض.

تحذير: بما أنّ واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" تستخدم مساحة معرّف مختلفة لإعدادات الاستهداف، يجب إعادة استرداد أي معلومات مخزّنة مؤقتًا من جداول ERF العامة من خلال واجهة برمجة التطبيقات.

عند استخدام Display & Video 360 API، يمكن استرجاع معلومات مرجعية للاستهداف من خلال خدمة targetingTypes.targetingOptions. على غرار الجداول العامة، توفّر هذه الخدمة أرقام التعريف وتفاصيل خيارات targeting لنوع استهداف محدّد. يُرجى الرجوع إلى صفحة ضبط الاستهداف الحالية للحصول على مثال على رمز يوضّح استرداد معرّف خيار الاستهداف.

ملاحظة: على الرغم من أنّ الطلبات المرسَلة إلى خدمة targetingTypes.targetingOptions تتطلّب رقم تعريف المعلِن، يجب أن تكون المعلومات التي يتم استرجاعها متطابقة على مستوى المعلِنين.

الجداول العامة وSDF

قبل الإصدار 7 من SDF، كانت "ملفات قراءة الكيانات" وملفات البيانات المنظَّمة تستخدمان مساحة التعريف نفسها لإعدادات الاستهداف. إذا كنت من مستخدمي SDF الذين يستخدمون جداول ERF العامة لتفسير إعدادات الاستهداف أو تعيينها باستخدام SDF، يمكنك بدلاً من ذلك تنزيل هذه المواد المرجعية بتنسيق CSV من خلال واجهة مستخدم "مساحة العرض والفيديو 360".

بدءًا من الإصدار 7، تم تعديل مساحات التعريف المستخدَمة من قِبل مجموعة فرعية من أعمدة "ملفّات البيانات المنظَّمة" (SDF) لفصل SDF عن "ملفّات المراجع عن المنتجات" (ERF) ومواءمة المزيد من ملفّات برمجة التطبيقات مع Display & Video 360 API. يُرجى الاطّلاع على دليل نقل بيانات الإصدار 7 والمستندات المرجعية للحصول على مزيد من المعلومات.

الموارد الخاصة

تقدّم جداول ERF الخاصة نبذة يومية عن الإعدادات الحالية للموارد الخاصة التي يملكها أحد الشركاء. بسبب العدد الهائل من الموارد التي يمكن إنشاؤها ضمن شريك واحد، يمكن أن تصبح هذه الملفات كبيرة جدًا ويصعب تنزيلها ومعالجتها.

في واجهة برمجة التطبيقات، يحتوي كل جدول خاص على خدمة مقابلة توفّر نقاط نهاية لاسترداد نوع المورد هذا وإدارته. يمكن استرداد الموارد بشكل مجمّع باستخدام طريقة القائمة الخاصة بكل خدمة. تختلف بنية ملف JSON لكل مورد في واجهة برمجة التطبيقات مقارنةً بتنسيق ERF، إذ تستخدِم أسماء حقول وموارد مشترَكة مختلفة.

إنّ بعض المعلومات المتوفّرة في تمثيل ERF لمصدر معيّن، مثل إعدادات الاستهداف المحدّدة للمصدر أو المواقع الإلكترونية للقناة، يتم تمثيلها في واجهة برمجة التطبيقات كعناصر فرعية للمصدر الأصلي ويجب retrieving من خلال طلبات إضافية لواجهة برمجة التطبيقات.

استرداد الكيانات في واجهة برمجة التطبيقات

يمكن استرداد موارد "مساحة العرض والفيديو 360" من خلال طلبات مباشرة لواجهة برمجة التطبيقات أو عمليات استيراد تلقائية إلى BigQuery.

طلبات البيانات المباشرة من واجهة برمجة التطبيقات

يمكن استرداد كل نوع من أنواع الموارد من خلال خدمة مختلفة لواجهة برمجة التطبيقات. يمكن retrieving الموارد بشكل فردي أو مجمّع باستخدام أسلوب get أو list في الخدمة المناسبة، على التوالي. تشمل السمات المهمة لطرق عرض Display & Video 360 API ما يلي:

• النطاق المطلوب: وعلى عكس ERF التي يتم تحديد نطاقها حسب الشريك، يتم تحديد نطاق معظم الموارد في واجهة برمجة التطبيقات من قِبل المعلِن. قد يتطلّب استرداد كل نوع من أنواع الموارد، مثل العناصر، ضمن شريك ما، تقديم طلب قائمة فردي لكل معلِن فرعي لهذا الشريك. تشمل الاستثناءات القنوات التابعة مباشرةً للشريك، مثل القنوات التي يملكها المعلِنون والقنوات التي يملكها الشركاء.
• الفهرسة. تستخدم طرق قوائم واجهات برمجة التطبيقات التقسيم على صفحات لضمان أن تكون الردود ضمن حجم معقول، ما يحدّ من معظم الردود على الطلبات الفردية أو الصفحات، إلى 100 مورد. إذا كان عدد الموارد ذات الصلة أكبر من حجم الصفحة، يجب إجراء طلبات متتالية للقائمة بهدف استرداد الصفحات اللاحقة من ردّ القائمة الكامل. يتوفر مثال لرمز نقل بيانات قائمة استجابة في قسم من صفحة دليل الاستهداف لدينا بشأن استرداد خيارات الاستهداف المتاحة .
• طلبات إضافية مطلوبة لاسترجاع البيانات. لا يتم تضمين إعدادات استهداف المورد في كائن JSON لواجهة برمجة التطبيقات، ولكنها بدلاً من ذلك موارد فرعية تُعرف باسم خيارات الاستهداف المحدّدة. يجب استرداد موارد الطفل هذه من خلال طلب منفصل. على سبيل المثال، لكل عنصر يتم استرجاعه من خلال طلب advertisers.lineItems.list، يجب تقديم طلب advertisers.lineItems.bulkListAssignedTargetingOptions منفصل لاسترداد كل معلومات الاستهداف.

تحسين استرداد الموارد

قد تتطلّب واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" طلبات متعددة لاسترداد الكمية نفسها من المعلومات المتوفّرة في ملف قراءة عناصر واحد. يمكن أن يساعد تحسين كيفية retrieving resources في استرداد البيانات التي تحتاج إليها بكفاءة أكبر:

• إجراء طلبات متزامنة إلى واجهة برمجة التطبيقات تحمي واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" البنية الأساسية باستخدام حدود معدل الطلبات لكل معلن لكل مشروع. تتيح لك بنية الحصة هذه تنفيذ حلّ متعدّد المواضيع على مستوى معلِنين متعدّدين، ما سيقلّل من الوقت الإجمالي الذي يستغرقه استرداد كل الموارد اللازمة. على الرغم من أنّ التقسيم على صفحات يتطلب استرداد جميع الموارد من نوع معيّن ضمن نطاق معيّن من خلال طلبات متتالية، يمكن استرداد الموارد في نطاق آخر أو من نوع آخر بشكلٍ متزامن.
• استخدِم الفلاتر والترتيب حسب المَعلمات في طلبات القائمة لاسترداد الموارد ذات الصلة فقط. على سبيل المثال، إذا كنت مهتمًا فقط بالعناصر التي تم تعديلها في اليوم الأخير، يمكنك استخدام المَعلمة filter في الأسلوب advertisers.lineItems.list لعرض العناصر التي تتضمن فقطupdateTime أكبر من طابع زمني معيّن. ويمكن أن يؤدي ذلك إلى تقليل عدد الطلبات التي يجب إجراؤها بشكل كبير.
• خزِّن المعرّفات المستخدمة بانتظام لتجنُّب الطلبات غير الضرورية من واجهة برمجة التطبيقات. بعض المعلومات المرجعية، مثل أرقام تعريف خيارات الاستهداف ومعرّفات الجمهور من Google، تكون ثابتة نسبيًا ويمكن تخزينها بأمان لتجنّب الحاجة إلى استردادها عند كل استخدام. ومع ذلك، يجب التحقّق من القيم المخزَّنة مؤقتًا على أساس أسبوعي لمراعاة التغييرات أو عمليات الإيقاف غير المتكرّرة.

اطّلِع على دليل تحسين الحصة للحصول على مزيد من المعلومات عن كيفية الوصول إلى واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360" بكفاءة.

الاستيراد إلى BigQuery

يتيح لك "موصّل BigQuery" في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" استيراد إعدادات موارد "مساحة العرض والفيديو 360" تلقائيًا إلى BigQuery يوميًا. يتم تخزين الإعدادات في BigQuery باستخدام موارد واجهة برمجة التطبيقات design في "مساحة العرض والفيديو 360". تتوفّر مجموعة فرعية من موارد واجهة برمجة التطبيقات.

اطّلِع على مستندات السحابة الإلكترونية التالية للحصول على مزيد من المعلومات عن استخدام موصّل BigQuery في Display & Video 360 API:

• ما هي خدمة نقل البيانات في BigQuery؟
• تحديد موعد لنقل البيانات في "مساحة العرض والفيديو 360"
• تحويل بيانات "مساحة العرض والفيديو 360"

الفجوات المعروفة في بيانات واجهة برمجة التطبيقات

هناك فجوات بيانات ملحوظة قد تواجهها عند نقل البيانات من ERF إلى Display & Video 360 API، مثل:

• طلبات إدراج القصص: لا يمكن استرداد طلبات إدراج القصص من خلال واجهة برمجة التطبيقات ويجب استردادها من خلال واجهة مستخدم "مساحة العرض والفيديو 360".
• مجموعة فرعية من حقول الموارد لا يتوفّر عدد صغير من حقول الموارد المتوفّرة في عناصر ERF في الموارد المقابلة التي يتم استرجاعها من خلال Display & Video 360 API.

الملحق: ربط حقول ERF بواجهة برمجة التطبيقات

ربط الجدول العلني

تربط الجداول أدناه حقول جداول ERF العامة بأنواع الاستهداف الحالية وحقول خيارات الاستهداف في واجهة برمجة التطبيقات لمساحة العرض والفيديو 360. على الرغم من أنّ قيمة حقل معيّن قد يتم ربطها بحقل آخر، لا يضمن ذلك أنّهما يستخدمان نوع البيانات أو قيم التعداد أو مساحة التعريف نفسها.

مجموعة التطبيقات

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_APP_CATEGORY.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل TargetingOption.targetingOptionId .
الاسم	حقل TargetingOption.appCategoryDetails.displayName

المتصفح

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_BROWSER.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	TargetingOption.targetingOptionId .
is_mobile	هذه الميزة غير متوفّرة.
الاسم	TargetingOption.browserDetails.displayName .

DataPartner

لا تتوفّر أيّ موارد أو حقول مكافئة في Display & Video 360 API.

DeviceCriteria

يمكن استرداد البيانات ضمن أنواع الاستهداف TARGETING_TYPE_OPERATING_SYSTEM وTARGETING_TYPE_DEVICE_MAKE_MODEL وTARGETING_TYPE_DEVICE_TYPE.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل TargetingOption.targetingOptionId أو DeviceType enum
is_mobile	هذه الميزة غير متوفّرة.
الاسم	حقل TargetingOption.operatingSystemDetails.displayName أو TargetingOption.deviceMakeModelDetails.displayName أو DeviceType ، حسب نوع الاستهداف
criteria_type	TargetingOption.targetingType .
operating_system_id	هذه الميزة غير متوفّرة.
mobile_brand_name	هذه الميزة غير متوفّرة.
mobile_model_name	هذه الميزة غير متوفّرة.
mobile_make_model_id	هذه الميزة غير متوفّرة.
device_type	تعداد DeviceType .

GeoLocation

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_GEO_REGION.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل TargetingOption.targetingOptionId
canonical_name	TargetingOption.geoRegionDetails.displayName .
geo_name	هذه الميزة غير متوفّرة.
country_code	هذه الميزة غير متوفّرة.
region_code	هذه الميزة غير متوفّرة.
city_name	هذه الميزة غير متوفّرة.
postal_name	هذه الميزة غير متوفّرة.
dma_code	هذه الميزة غير متوفّرة.

Isp

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_CARRIER_AND_ISP.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل TargetingOption.targetingOptionId
is_mobile	هذه الميزة غير متوفّرة.
الاسم	TargetingOption.carrierAndIspDetails.displayName .
secondary_criteria_id	حقل TargetingOption.targetingOptionId .

اللغة

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_LANGUAGE.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل TargetingOption.targetingOptionId
الاسم	هذه الميزة غير متوفّرة. يتوفّر الاسم المعروض الكامل لإحدى اللغات في حقل TargetingOption.languageDetails.displayName .

SiteToPlacementId

لا تتوفّر أيّ موارد أو حقول مكافئة في Display & Video 360 API.

SupportedExchange

يمكن استرجاعها ضمن نوع الاستهداف TARGETING_TYPE_EXCHANGE.

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	Exchange enum.
الاسم	Exchange enum.

UniversalSite

لا تتوفّر أيّ موارد أو حقول مكافئة في Display & Video 360 API. يمكن استهداف المواقع الإلكترونية والتطبيقات الفردية مباشرةً ضمن نوعَي الاستهداف TARGETING_TYPE_URL وTARGETING_TYPE_APP، على التوالي. في "مساحة العرض والفيديو 360"، يمكن استهداف أيّ تطبيق أو عنوان URL، ولكن لا يمكن الإبلاغ عن كلّ تطبيق أو عنوان URL. إذا أردت إزالة التطبيقات وعناوين URL غير القابلة للإبلاغ عنها من الإنفاق، اتّبِع التعليمات الواردة في مركز مساعدة DV360.

ربط حقول الجدول الخاص

تربط الجداول أدناه حقول جداول ERF الخاصة ب الحقول أو الخدمات الحالية في Display & Video 360 API. على الرغم من أنّه قد يتم ربط قيمة حقل واحد بحقل آخر، لا يضمن ذلك استخدامهما لنوع البيانات نفسه أو قيم التعداد أو مساحة التعريف.

المعلِن

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	حقل Advertiser.advertiserId
common_data.name	حقل Advertiser.displayName .
common_data.active	حقل Advertiser.entityStatus .
common_data.integration_code	Advertiser.integrationDetails.integrationCode .
partner_id	حقل Advertiser.partnerId
currency_code	حقل Advertiser.generalConfig.currencyCode .
timezone_code	حقل Advertiser.generalConfig.timeZone
landing_page_url	Advertiser.generalConfig.domainUrl .
available_channel_ids	يمكن استردادها من خلال طريقة advertisers.channels.list .
blacklist_channel_id	يمكن استرجاعها من خلال advertisers.targetingTypes.assignedtargetingOptions.list الطريقة ضمن نوع الاستهداف TARGETING_TYPE_CHANNEL . إذا كانت قيمة AssignedTargetingOption.channelDetails.negative صحيحة، تكون القناة مستهدفة بشكل سلبي.
dcm_configuration	هذه الميزة غير متوفّرة.
dcm_network_id	حقل Advertiser.adServerConfig.cmHybridConfig.cmAccountId
dcm_advertiser_id	يسرد الحقل Advertiser.adServerConfig.cmHybridConfig.cmAdvertiserIds أرقام تعريف المعلنين في "مدير الحملة 360" التي تتشارك إعدادات Floodlight في "مدير الحملة 360".
dcm_floodlight_group_id	حقل Advertiser.adServerConfig.cmHybridConfig.cmFloodlightConfigId
dcm_syncable_site_ids	حقل Advertiser.adServerConfig.cmHybridConfig.cmSyncableSiteIds
enable_oba_tags	هذه الميزة غير متوفّرة.

الحملة

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	حقل Campaign.campaignId .
common_data.name	حقل Campaign.displayName
common_data.active	حقل Campaign.entityStatus .
common_data.integration_code	هذه الميزة غير متوفّرة.
advertiser_id	حقل Campaign.advertiserId .
الميزانية	حقلَا Campaign.campaignFlight و Campaign.campaignBudgets
frequency_cap	حقل Campaign.frequencyCap
default_target_list	يمكن استرجاعها من خلال advertisers.campaigns.bulkListCampaignAssignedTargetingOptions .
uses_video_creatives	هذه الميزة غير متوفّرة.
uses_display_creatives	هذه الميزة غير متوفّرة.
uses_audio_creatives	هذه الميزة غير متوفّرة.
هدف	حقل Campaign.campaignGoal.campaignGoalType .
المقياس	حقل Campaign.campaignGoal.performanceGoal.performanceGoalType .
objective_description	حقل Campaign.campaignGoal.performanceGoal.performanceGoalString .
metric_amount_micros	حقل Campaign.campaignGoal.performanceGoal.performanceGoalAmountMicros

تصاميم الإعلانات

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	حقل Creative.creativeId
common_data.name	حقل Creative.displayName
common_data.active	حقل Creative.entityStatus .
common_data.integration_code	حقل Creative.integrationCode .
advertiser_id	Creative.advertiserId .
dcm_placement_id	حقل Creative.cmPlacementId
width_pixels	Creative.dimensions.widthPixels .
height_pixels	حقل Creative.dimensions.heightPixels
approval_status	حقل Creative.reviewStatus .
expanding_direction	حقل Creative.expandingDirection .
creative_type	Creative.creativeType .

CustomAffinity

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل CustomList.customListId .
الاسم	حقل CustomList.displayName
الوصف	هذه الميزة غير متوفّرة.
advertiser_id	هذه الميزة غير متوفّرة.

FloodlightActivity

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	FloodlightActivity.floodlightActivityId .
common_data.name	حقل FloodlightActivity.displayName
common_data.active	حقل FloodlightActivity.servingStatus
common_data.integration_code	هذه الميزة غير متوفّرة.
advertiser_id	يسرد الحقل FloodlightActivity.advertiserIds جميع المعلِنين الذين يمكنهم الوصول إلى نشاط Floodlight ضمن الشريك المحدّد.
partner_id	يقدّمه المستخدم عند تقديم طلب إلى خدمة floodlightGroups.floodlightActivities.
remarketing_enabled	يسرد الحقل FloodlightActivity.remarketingConfigs هذه الإعدادات لكلّ معلِن يمكنه الوصول إلى نشاط Floodlight ضمن الشريك المحدّد.
ssl_required	حقل FloodlightActivity.sslRequired

InsertionOrder

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	حقل InsertionOrder.insertionOrderId .
common_data.name	حقل InsertionOrder.displayName .
common_data.active	حقل InsertionOrder.entityStatus .
common_data.integration_code	حقل InsertionOrder.integrationDetails.integrationCode
advertiser_id	حقل InsertionOrder.advertiserId
campaign_id	InsertionOrder.campaignId .
overall_budget	هذه الميزة غير متوفّرة. يمكن احتسابه باستخدام محتوى الحقل InsertionOrder.budget.budgetSegments .
scheduled_segments	حقل InsertionOrder.budget.budgetSegments
frequency_cap	حقل InsertionOrder.frequencyCap .
default_partner_costs	حقل InsertionOrder.partnerCosts
default_target_list	يمكن استرجاعها من خلال advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions .

InventorySource

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	InventorySource.inventorySourceId .
غير مصنّف	هذه الميزة غير متوفّرة.
inventory_name	حقل InventorySource.displayName
exchange_id	InventorySource.exchange .
accessing_advertisers	حقلَا InventorySource.readWriteAccessors و InventorySource.readAdvertiserIds
external_id	حقل InventorySource.dealId
min_cpm_micros	حقل InventorySource.rateDetails.rate.nanos ، استنادًا إلى قيمة حقل InventorySource.rateDetails.inventorySourceRateType
min_cpm_currency_code	حقل InventorySource.rateDetails.rate.currencyCode .

LineItem

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	حقل LineItem.lineItemId .
common_data.name	LineItem.displayName .
common_data.active	LineItem.entityStatus .
common_data.integration_code	حقل LineItem.integrationDetails.integrationCode .
line_item_type	حقل LineItem.lineItemType
insertion_order_id	حقل LineItem.insertionOrderId
creative_ids	حقل LineItem.creativeIds .
max_cpm_advertiser_micros	حقلَي LineItem.bidStrategy.maximizeSpendAutoBid.maxAverageCpmBidAmountMicros أو LineItem.bidStrategy.performanceGoalAutoBid.maxAverageCpmBidAmountMicros ، استنادًا إلى مخطّط الاستراتيجية المستخدَم
performance_goal	حقلَي LineItem.bidStrategy.maximizeSpendAutoBid.performanceGoalType أو LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalType ، استنادًا إلى مخطّط الاستراتيجية المستخدَم
goal_advertiser_micros	حقل LineItem.bidStrategy.performanceGoalAutoBid.performanceGoalAmountMicros .
partner_revenue_model	حقل LineItem.partnerRevenueModel
cost_tracking_pixels	LineItem.conversionCounting.floodlightActivityConfigs .
budget.start_time_usec	حقل LineItem.flight.dateRange.startDate .
budget.end_time_usec	LineItem.flight.dateRange.endDate .
budget.max_impressions	LineItem.budget.maxAmount إذا كانت قيمة LineItem.budget.budgetUnit هي BUDGET_UNIT_IMPRESSIONS .
budget.max_spend_advertiser_micros	حقل LineItem.budget.maxAmount إذا كان LineItem.budget.budgetUnit هو BUDGET_UNIT_CURRENCY .
budget.pacing_type	حقل LineItem.pacing.pacingPeriod .
budget.pacing_max_impressions	LineItem.pacing.dailyMaxImpressions .
budget.pacing_max_spend_advertiser_micros	حقل LineItem.pacing.dailyMaxMicros
budget.pacing_distribution	حقل LineItem.pacing.pacingType .
frequency_cap	LineItem.frequencyCap .
partner_costs	حقل LineItem.partnerCosts
target_list	يمكن استردادها من خلال طريقة advertisers.lineItems.bulkListLineItemAssignedTargetingOptions .

NegativeKeywordList

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل NegativeKeywordList.negativeKeywordListId .
الاسم	حقل NegativeKeywordList.displayName
advertiser_id	حقل NegativeKeywordList.advertiserId .

شريك

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
common_data.id	Partner.partnerId .
common_data.name	حقل Partner.displayName
common_data.active	حقل Partner.entityStatus .
common_data.integration_code	هذه الميزة غير متوفّرة.
currency_code	حقل Partner.generalConfig.currencyCode .
exchange_settings	Partner.exchangeConfig.enabledExchanges .
default_partner_costs	هذه الميزة غير متوفّرة.
default_partner_revenue	هذه الميزة غير متوفّرة.
default_target_list	هذه الميزة غير متوفّرة.

Pixel

لا تتوفّر أيّ موارد أو حقول مكافئة في Display & Video 360 API.

UniversalChannel

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل Channel.channelId
الاسم	حقل Channel.displayName .
site_ids	يمكن استرجاعها من خلال الطريقتَين advertisers.channels.sites.list و partners.channels.sites.list ، استنادًا إلى نوع owner .
accessing_advertisers	هذه الميزة غير متوفّرة.
is_deleted	هذه الميزة غير متوفّرة.
is_brand_safe_channel	هذه الميزة غير متوفّرة.

UserList

اسم حقل ERF	مدى توفّر واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360"
id	حقل FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId
الاسم	حقل FirstAndThirdPartyAudience.displayName
data_partner_id	هذه الميزة غير متوفّرة.
accessing_advertisers	هذه الميزة غير متوفّرة.
partner_pricing	هذه الميزة غير متوفّرة.
advertiser_pricings	هذه الميزة غير متوفّرة.