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

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

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

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

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

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

نظرة عامة

عند نقل البيانات من ERF إلى Display & Video 360 API، هناك عدد من الاختلافات الرئيسية التي يجب أخذها في الاعتبار، بما في ذلك:

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

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

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

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

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

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

تحذير: بما أنّ واجهة برمجة التطبيقات Display & Video 360 API تستخدِم مساحة أرقام تعريف مختلفة لإعدادات الاستهداف، يجب إعادة استرجاع أي معلومات محفوظة مؤقتًا من الجداول العامة لميزة "الاستهداف بالاستناد إلى الجمهور المستهدَف" من خلال واجهة برمجة التطبيقات.

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

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

الجداول وتنسيقات SDF العلنية

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ربط الجداول العامة

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

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

يمكن استرجاعها ضمن نوع الاستهداف 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 قائمة أرقام صحيحة
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 enum.

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	غير متوفر
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	هذه الميزة غير متوفّرة.

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.bulkListAssignedTargetingOptions .

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	حقل FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId .
الاسم	حقل FirstPartyAndPartnerAudience.displayName .
data_partner_id	هذه الميزة غير متوفّرة.
accessing_advertisers	هذه الميزة غير متوفّرة.
partner_pricing	هذه الميزة غير متوفّرة.
advertiser_pricings	هذه الميزة غير متوفّرة.