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

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

يُرجى العلم أنّ "ملفات قراءة الكيان" لا تتوفّر إلا لمدة 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