العرض تم إيقاف الإصدار الثاني من Video 360 API. استخدام الشاشة & الإصدار 3 من Video 360 API بدلاً من ذلك. للحصول على تعليمات حول نقل البيانات من الإصدار 2 إلى الإصدار 3، يُرجى الاطّلاع على دليل نقل البيانات.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

ملفات قراءة الكيانات (ERFs) هي تمثيلات JSON لكائنات حملة الشريك التي يتم إنشاؤها يوميًا عند الطلب وإتاحتها من خلال Google Cloud Storage.

تم إيقاف ERFs نهائيًا في حزيران (يونيو) 2021. اعتبارًا من 31 تشرين الأول (أكتوبر) 2024، سيتم إيقاف ERF رسميًا نهائيًا ولن يتم إنشاؤها بعد ذلك. ننصح جميع مستخدمي "ملفات قراءة الكيانات" الحاليين بنقل بياناتهم إلى واجهة برمجة تطبيقات "مساحة العرض والفيديو 360" من أجل مواصلة استرداد موارد "مساحة العرض والفيديو 360".

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

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

نظرة عامة

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

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

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

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

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

المعلومات العلنية

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

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

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

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

بدءًا من الإصدار 7، تم تعديل مساحات أرقام التعريف التي تستخدمها مجموعة فرعية من أعمدة ملفات البيانات المنظَّمة للفصل بين وحدات SDF وERFs وإحداث توافق أكبر مع واجهة برمجة التطبيقات Display & Video 360 API. يمكنك الاطّلاع على دليل نقل البيانات إلى الإصدار 7 من Google والمستندات المرجعية للتعرّف على مزيد من المعلومات.

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

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

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

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

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

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

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

يمكن استرداد كل نوع من أنواع الموارد من خلال خدمة واجهة برمجة تطبيقات مختلفة. يمكن استرداد الموارد بشكل فردي أو مجمّع باستخدام طريقة get أو list (إدراج) للخدمة المناسبة، على التوالي. تشمل الخصائص المهمة لطرق قائمة "مساحة العرض والفيديو 360 API" ما يلي:

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

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

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

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

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

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

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

يمكنك الاطّلاع على مستندات السحابة الإلكترونية التالية للحصول على مزيد من المعلومات حول استخدام موصل BigQuery لـ "مساحة العرض والفيديو 360 API":

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

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

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

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

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

تربط الجداول أدناه حقول جداول ERF العامة بأنواع الاستهداف الحالية وحقول خيارات الاستهداف في "مساحة العرض والفيديو 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

لا يتوفّر مورد أو حقول مكافئة في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

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

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

لا يتوفّر مورد أو حقول مكافئة في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

SupportedExchange

قابلة للاسترداد ضمن نوع الاستهداف TARGETING_TYPE_EXCHANGE.

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

UniversalSite

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

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

تربط الجداول أدناه حقول جداول ERF الخاصة بالحقول أو الخدمات الحالية في "مساحة العرض والفيديو 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

لا يتوفّر مورد أو حقول مكافئة في واجهة برمجة التطبيقات "مساحة العرض والفيديو 360".

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