REST Resource: assets

Zasób: Asset

Zasób asset reprezentuje własność intelektualną, np. nagranie dźwiękowe lub odcinek serialu telewizyjnego.

Zapis JSON
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
Pola
kind

string

Typ zasobu interfejsu API. Dla asset zasobów wartość wynosi youtubePartner#asset.

type

string

Typ zasobu. Ta wartość określa pola metadanych, które możesz ustawić dla zasobu. Dodatkowo niektóre funkcje interfejsu API mogą być obsługiwane tylko w przypadku określonych typów zasobów. Na przykład zasoby kompozycji mogą mieć bardziej złożone dane o własności niż zasoby innych typów
.

Prawidłowe wartości dla tej właściwości to:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web

status

string

Stan zasobu.

metadata

object (Metadata)

Obiekt metadata zawiera informacje identyfikujące i opisujące zasób. Informacje te można wykorzystać do wyszukania zasobu lub do wyeliminowania duplikatów w bazie danych YouTube.

ownership

object (RightsOwnership)

Obiekt ownership określa właścicieli zasobu i zawiera dodatkowe informacje o ich własności, np. obszary, na których są oni właścicielami zasobu.

matchPolicy

object (AssetMatchPolicy)

Obiekt matchPolicy zawiera informacje o zasadach dopasowania zasobu, które YouTube stosuje do pasujących do niego filmów przesłanych przez użytkowników.

timeCreated

string

Data i godzina utworzenia zasobu. Wartość jest podana w formacie RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).

metadataMine

object (Metadata)

metadataEffective

object (Metadata)

ownershipMine

object (RightsOwnership)

ownershipEffective

object (RightsOwnership)

matchPolicyMine

object (AssetMatchPolicy)

matchPolicyEffective

object (AssetMatchPolicy)

ownershipConflicts

object (OwnershipConflicts)

Obiekt ownershipConflicts zawiera informacje o konfliktach własności zasobu.

id

string

Przypisywany przez YouTube identyfikator, który służy do jednoznacznej identyfikacji zasobu.

aliasId[]

string

Lista identyfikatorów zasobów, których można użyć do odwoływania się do zasobu. Jeśli zasób reprezentuje wiele scalonych zasobów składowych, lista zawiera wartości. W takim przypadku można użyć dowolnego z identyfikatorów zasobów pierwotnie przypisanych do zasobów cząstkowych, by zaktualizować zasób główny lub zsyntetyzowany.

label[]

string

Lista etykiet zasobu.

licensability

object (AssetLicensability)

Informacje o zasobach dotyczące możliwości uzyskania licencji.

nWayRevenueSharing

object (NWayRevenueSharing)

Informacje o dzieleniu się przychodami (Pangea).

OwnershipConflicts

Zasób ownershipConflicts zawiera informacje o konflikcie własności zasobu.

Zapis JSON
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
Pola
general[]

object (TerritoryConflicts)

Lista identyfikująca konflikty własności związane z zasobem i regionami, w których występuje konflikt własności.

performance[]

object (TerritoryConflicts)

Lista określająca konflikty własności dotyczące praw do wykonywania związanych z zasobem kompozycji oraz terytoria, w których występuje konflikt własności.

synchronization[]

object (TerritoryConflicts)

Lista określająca konflikty własności dotyczące praw do synchronizacji zasobu kompozycji i regionów, w których występuje konflikt własności.

mechanical[]

object (TerritoryConflicts)

Lista określająca konflikty własności praw mechanicznych do zasobu kompozycji oraz regiony, w których występuje konflikt własności.

kind

string

Typ zasobu interfejsu API. Dla ownershipConflicts zasobów wartość wynosi youtubePartner#ownershipConflicts.

TerritoryConflicts

Metoda wyszukiwania terroryzmu konfliktów własności.

Zapis JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
Pola
territory

string

Regiony, w których występuje konflikt własności. „terytorium” to dwuliterowy kod kraju w formacie ISO 3166.

conflictingOwnership[]

object (ConflictingOwnership)

Lista własności będących w konflikcie.

ConflictingOwnership

Reprezentuje informacje o jednym z kolidujących własności.

Zapis JSON
{
  "ratio": number,
  "owner": string
}
Pola
ratio

number

Odsetek zasobów, którymi właściciel zarządza lub którymi zarządza.

owner

string

Identyfikator właściciela zasobu powodującego konflikt.

AssetLicensability

Informacje o zasobach dotyczące możliwości uzyskania licencji.

Zapis JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
Pola
licensable

boolean

Określa, czy uzgodniony zasób kwalifikuje się do licencjonowania.

licensabilityState

string

Stan możliwości uzyskania licencji na zasób.

unlicensableReason[]

string

Powód, dla którego zasób nie jest licencjonowany.

NWayRevenueSharing

Dzielenie się przychodami zasobu informacyjnego

Zapis JSON
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
Pola
status

string

Stan dwukierunkowego dzielenia się przychodami.

eligibleTerritories[]

string

Każdy kraj jest reprezentowany przez dwuliterowy kod ISO kraju (ISO 3166-1 alfa-2).

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Informacje o regionach, w których zasób nie kwalifikuje się do innego dzielenia się przychodami.

TerritoriesIneligibleForNWayRevenueSharing

Informacje o regionach, w których zasób nie kwalifikuje się do systemu dzielenia się przychodami.

Zapis JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
Pola
reason

string

Powód niezakwalifikowania w przypadku kategorii wymienionych poniżej.

territories[]

string

Każdy kraj jest reprezentowany przez dwuliterowy kod ISO kraju (ISO 3166-1 alfa-2).

Metody

get

Pobiera metadane określonego zasobu.

insert

Wstawia zasób z określonymi metadanymi.

list

Pobiera listę zasobów na podstawie metadanych zasobu.

patch

Poprawia metadane określonego zasobu.

update

Aktualizuje metadane określonego zasobu.