REST Resource: campaigns

منبع: کمپین

یک منبع campaign نشان‌دهنده یک کمپین مالک محتوای خاص است که به مالک محتوا اجازه می‌دهد از حاشیه‌نویسی برای تبلیغ محتوا در ویدیوهای ادعا شده و بارگذاری‌شده توسط کاربر استفاده کند. به عنوان مثال، یک مالک محتوا می‌تواند کمپینی ایجاد کند که پیوندهایی را به صفحه تماشای فیلم برای هر ویدیوی ادعا شده و آپلود شده توسط کاربر که حاوی صحنه‌هایی از آن فیلم است، اضافه کند. یک مالک محتوای YouTube می تواند تا 5000 کمپین ایجاد کند.

نمایندگی JSON
{
  "kind": string,
  "status": string,
  "campaignData": {
    object (CampaignData)
  },
  "timeCreated": string,
  "timeLastModified": string,
  "id": string
}
زمینه های
kind

string

نوع منبع API. برای منابع campaign ، این مقدار youtubePartner#campaign است.

status

string

وضعیت کمپین

campaignData

object ( CampaignData )

شی campaignData حاوی جزئیاتی مانند تاریخ شروع و پایان کمپین، هدف و منبع است.

timeCreated

string

زمانی که کمپین ایجاد شد.

timeLastModified

string

زمانی که کمپین آخرین بار اصلاح شد.

id

string

شناسه منحصربه‌فردی که YouTube برای شناسایی کمپین استفاده می‌کند.

CampaignData

این شی حاوی اطلاعات جزئی در مورد یک کمپین مانند تاریخ شروع و پایان، هدف و منبع یک کمپین است.

نمایندگی JSON
{
  "name": string,
  "startTime": string,
  "expireTime": string,
  "campaignSource": {
    object (CampaignSource)
  },
  "promotedContent": [
    {
      object (PromotedContent)
    }
  ]
}
زمینه های
name

string

نام کاربر کمپین.

startTime

string

زمانی که کمپین باید شروع شود. اگر کمپین باید بلافاصله شروع شود، مقداری را مشخص نکنید.

expireTime

string

زمانی که کمپین باید در آن منقضی شود. اگر کمپین زمان انقضا ندارد، مقداری را مشخص نکنید.

campaignSource

object ( CampaignSource )

شی campaignSource حاوی اطلاعاتی در مورد دارایی هایی است که کمپین برای آنها پیوند ایجاد می کند.

promotedContent[]

object ( PromotedContent )

فهرستی از ویدیوها یا کانال‌هایی که از ویدیوهای ادعا شده که در کمپین گنجانده شده‌اند به آنها پیوند داده می‌شود.

منبع کمپین

منبع campaignSource حاوی نوع و مقادیر منابع یک کمپین است که تعیین می کند کدام ویدیوها با محتوای تبلیغاتی تبلیغ می شوند.

نمایندگی JSON
{
  "sourceType": string,
  "sourceValue": [
    string
  ]
}
زمینه های
sourceType

string

نوع منبع کمپین

sourceValue[]

string

فهرستی از مقادیر منبع کمپین.

محتوای تبلیغ شده

این شیء حاوی پیوندهایی به عنوان هدف تبلیغاتی یک کمپین است.

نمایندگی JSON
{
  "link": [
    {
      object (CampaignTargetLink)
    }
  ]
}
زمینه های
مواد و روش ها
delete یک کمپین مشخص شده برای یک مالک را حذف می کند.
get یک کمپین خاص را برای یک مالک بازیابی می کند.
insert با استفاده از داده های کمپین مشخص شده، یک کمپین جدید برای مالک وارد کنید.
list فهرستی از کمپین ها را برای یک مالک بازیابی می کند.
patch داده ها را برای یک کمپین خاص وصله کنید.
update داده ها را برای یک کمپین خاص به روز کنید.