الوصول إلى ملفات قراءة الكيان

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

تجدر الإشارة إلى أنّ ملفات قراءة البيانات عن الكيانات لا تتوفّر إلا لمدة 60 يومًا من تاريخ معالجتها.

يمكن الاطّلاع على تنسيق ملفات قراءة الكيانات في مرجع تنسيق الملف.

يتم تخزين ملفات قراءة الكيان كمجموعتَين:

  • الجداول العامة التي تحتوي على بيانات عامة شائعة، مثل معلومات عن إصدارات المتصفّح أو اللغات المخزّنة في حزمة gdbm-public
  • الجداول الخاصة التي تحتوي على معلومات عن حملات الشريك وميزانياته وغيرها من البيانات الخاصة يتم تخزين الجداول الخاصة في حِزم خاصة بالشركاء. على سبيل المثال، إذا كان معرّف الشريك هو 123، ستكون الحزمة التي تحتوي على الجداول الخاصة هي gdbm-123.
تتوفّر الجداول العامة والخاصة في دليل فرعي entity ضمن الحزمة. لمزيد من المعلومات عن التعامل مع الدلائل الفرعية، يُرجى الاطّلاع على مساحة الاسماء للكائنات في Cloud Storage.
يتم إنشاء الجداول العامة في الساعة 5 صباحًا بالتوقيت العالمي المنسّق. يتم إنشاء الجداول الخاصة في الساعة 5 صباحًا حسب المنطقة الزمنية لشريكك (ولكن قد يحدث تأخير في بعض الحالات النادرة) ويتم تخزينها تلقائيًا وبأمان في Google Cloud Storage. يتم إنشاء ملف تلخيصي بعد إنشاء جميع الجداول العامة والخاصة.

الجداول العلنية

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
الحقلالوصف
processing_dateالتاريخ الذي عالجت فيه "مساحة العرض والفيديو 360" البيانات، ولا يرتبط بالضرورة بالأحداث المضمّنة في الملف. تنسيق التاريخ هو YYYYMMDD، على سبيل المثال، 20120320 هو 20 آذار (مارس) 2012.
batch_index فهرس الدفعة بقيمة صفرية على سبيل المثال، إذا كان يتم إنشاؤه كل ساعة، ستكون الدُفعة الأولى 0، وستكون الدُفعة الثانية 1، وهكذا.
entity_typeنوع الملف: SupportedExchange DataPartner وUniversalSite GeoLocation وLanguage وOperatingSystem وBrowser Isp وsummary وSiteIdToPlacementId.csv
على سبيل المثال، إذا كنت تنشئ اسم ملف لاسترداد ملف قراءة الكيانات لجدول browser من 15 كانون الثاني (يناير) 2013، سيبدو مسار الملف على النحو التالي: 
gdbm-public/entity/20130115.0.Browser.json

الجداول الخاصة

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
الحقلالوصف
partner_idالمعرّف الرقمي لشريكك.
processing_dateالتاريخ الذي عالجت فيه "مساحة العرض والفيديو 360" البيانات. لا يرتبط هذا التاريخ بالضرورة بالأحداث الواردة في الملف. تنسيق التاريخ هو YYYYMMDD، على سبيل المثال 20120320 ستكون 20 آذار (مارس) 2012. سيتم إنشاء الملفات بين الساعة 4 صباحًا و6 صباحًا حسب المنطقة الزمنية للشريك.
batch_indexفهرس للدفعة يبدأ من الصفر وتكون هذه القيمة حاليًا 0 دائمًا.
entity_typeنوع الملف: Partner وAdvertiser وInsertionOrder وLineItem وCreative وPixel وInventorySource وUserList وUniversalChannel وsummary
على سبيل المثال، إذا كنت تنشئ اسم ملف لاسترداد ملف قراءة الكيانات للشريك 123 الذي يصل إلى جدول line_item اعتبارًا من 2 نيسان (أبريل) 2013، سيظهر اسم الملف على النحو التالي: 
gdbm-123/entity/20130402.0.LineItem.json