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

ملفات قراءة الكيانات (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" تستخدم مساحة معرّف مختلفة لإعدادات الاستهداف، يجب استرداد أي معلومات تم تخزينها مؤقتًا من الجداول العامة ERF من خلال واجهة برمجة التطبيقات.

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

ملاحظة: على الرغم من أنّ الطلبات الواردة إلى خدمة 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":

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

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

هناك فجوات ملحوظة في البيانات قد تواجهها عند نقل البيانات من 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	هذه الميزة غير متوفّرة.