REST Resource: sellers.adPlays

المرجع: AdPlay

تشغيل إعلان واحد.

تمثيل JSON 
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "impressionCount": number,

  // Union field line_reference can be only one of the following:
  "line": string,
  "lineExternalId": string
  // End of list of possible types for union field line_reference.

  // Union field ad_unit_reference can be only one of the following:
  "adUnit": string,
  "adUnitExternalId": string
  // End of list of possible types for union field ad_unit_reference.

  // Union field creative_asset_reference can be only one of the following:
  "creativeAsset": string,
  "creativeAssetExternalId": string
  // End of list of possible types for union field creative_asset_reference.
}
الحقول
name

string

النتائج فقط. يتم تشغيل اسم المورد للإعلان بالتنسيق: sellers/{seller}/adPlays/{adPlay}.
startTime

string (Timestamp format)

وقت بدء تشغيل الإعلان

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

وقت انتهاء تشغيل الإعلان

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
impressionCount

number

إجمالي عدد مرات الظهور يمكن تقدير عدد مرات الظهور واستخدام قيم كسرية.

حقل الاتحاد line_reference.

يمكن أن يكون line_reference واحدًا فقط مما يلي:
line

string

السطر الذي ينتمي إليه تشغيل هذا الإعلان. سيتم استنتاج الترتيب من السطر. التنسيق: sellers/111/orders/123/lines/321
lineExternalId

string

الإدخال فقط. المعرّف الخارجي للسطر الذي ينتمي إليه هذا الإعلان. سيتم استنتاج الترتيب من السطر. التنسيق: 123

حقل الاتحاد ad_unit_reference.

يمكن أن يكون ad_unit_reference واحدًا فقط مما يلي:
adUnit

string

الوحدة الإعلانية التي تم عرض هذا الإعلان عليها. التنسيق: sellers/111/adUnits/123
adUnitExternalId

string

الإدخال فقط. المعرّف الخارجي للوحدة الإعلانية التي تم عرض هذا الإعلان عليها. التنسيق: 789

حقل الاتحاد creative_asset_reference.

يمكن أن يكون creative_asset_reference واحدًا فقط مما يلي:
creativeAsset

string

مادة عرض تصميم الإعلان التي تم عرضها في هذا الإعلان التنسيق: sellers/111/creativeAssets/123
creativeAssetExternalId

string

الإدخال فقط. المعرّف الخارجي لملف أصل تصميم الإعلان الذي تم عرضه هذا الإعلان. التنسيق: 3210

الطُرق

batchCreate

 تنشئ عمليات تشغيل جديدة للإعلانات دفعة واحدة.

create

 إنشاء عملية تشغيل للإعلان