REST Resource: campaigns

Zasób: Campaign

campaignZasób reprezentuje konkretną kampanię właściciela treści, która umożliwia właścicielowi treści używanie adnotacji do promowania treści w filmach przesłanych przez użytkowników, do których zgłoszono roszczenie. Na przykład właściciel treści może utworzyć kampanię, która dodaje linki do strony odtwarzania filmu w przypadku wszystkich objętych roszczeniem filmów przesłanych przez użytkowników, które zawierają sceny z tego filmu. Właściciel treści w YouTube może utworzyć maksymalnie 5 tysięcy kampanii.

Zapis JSON 
{
  "kind": string,
  "status": string,
  "campaignData": {
    object (CampaignData)
  },
  "timeCreated": string,
  "timeLastModified": string,
  "id": string
}
Pola
kind

string

Typ zasobu interfejsu API. W przypadku zasobów campaign ta wartość to youtubePartner#campaign.
status

string

Stan kampanii.

Akceptowane wartości:

  • active
  • inactive
campaignData

object (CampaignData)

Obiekt campaignData zawiera szczegóły takie jak daty rozpoczęcia i zakończenia kampanii, cel i źródło.
timeCreated

string

Czas utworzenia kampanii.
timeLastModified

string

Czas ostatniej modyfikacji kampanii.
id

string

Unikalny identyfikator używany przez YouTube do identyfikowania kampanii.

CampaignData

Ten obiekt zawiera szczegółowe informacje o kampanii, takie jak data rozpoczęcia i zakończenia, cel i źródło kampanii.

Zapis JSON 
{
  "name": string,
  "startTime": string,
  "expireTime": string,
  "campaignSource": {
    object (CampaignSource)
  },
  "promotedContent": [
    {
      object (PromotedContent)
    }
  ]
}
Pola
name

string

Nazwa kampanii podana przez użytkownika.
startTime

string

Godzina rozpoczęcia kampanii. Jeśli kampania ma się rozpocząć natychmiast, nie podawaj wartości.
expireTime

string

Czas, w którym kampania powinna wygasnąć. Nie podawaj wartości, jeśli kampania nie ma daty ważności.
campaignSource

object (CampaignSource)

Obiekt campaignSource zawiera informacje o zasobach, dla których kampania będzie generować linki.
promotedContent[]

object (PromotedContent)

Lista filmów lub kanałów, do których będą prowadzić linki z filmów objętych roszczeniem, które są uwzględnione w kampanii.

CampaignSource

campaignSource zawiera typ i wartości źródeł kampanii, które określają, które filmy będą promowane za pomocą treści promocyjnych.

Zapis JSON 
{
  "sourceType": string,
  "sourceValue": [
    string
  ]
}
Pola
sourceType

string

Typ źródła kampanii.

Akceptowane wartości:

  • asset_id
  • asset_label_name
sourceValue[]

string

Lista wartości źródła kampanii.

PromotedContent

Ten obiekt zawiera linki jako cel promocyjny kampanii.

Zapis JSON 
{
  "link": [
    {
      object (CampaignTargetLink)
    }
  ]
}
Pola

Metody

delete

 Usuwa określoną kampanię właściciela.

get

 Pobiera konkretną kampanię właściciela.

insert

 Wstaw nową kampanię dla właściciela, używając podanych danych kampanii.

list

 Pobiera listę kampanii właściciela.

patch

 Zaktualizuj dane konkretnej kampanii.

update

 Zaktualizuj dane dotyczące konkretnej kampanii.