REST Resource: assets

Risorsa: asset

Una risorsa asset rappresenta una proprietà intellettuale, ad esempio una registrazione audio o una puntata televisiva.

Rappresentazione 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)
  }
}
Campi
kind

string

Il tipo di risorsa API. Per asset risorse, il valore è youtubePartner#asset.

type

string

Il tipo di risorsa. Questo valore determina i campi dei metadati che puoi impostare per la risorsa. Inoltre, alcune funzioni dell'API potrebbero essere supportate solo per tipi di asset specifici. Ad esempio, le risorse di composizione possono avere dati sulla proprietà più complessi rispetto ad altri tipi di risorse.

I valori validi per questa proprietà sono:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web

status

string

Lo stato dell'asset.

metadata

object (Metadata)

L'oggetto metadata contiene informazioni che identificano e descrivono la risorsa. Queste informazioni possono essere utilizzate per cercare la risorsa o per eliminare duplicati all'interno del database di YouTube.

ownership

object (RightsOwnership)

L'oggetto ownership identifica i proprietari di una risorsa e fornisce ulteriori dettagli sulla loro proprietà, ad esempio i territori in cui sono proprietari della risorsa.

matchPolicy

object (AssetMatchPolicy)

L'oggetto matchPolicy contiene informazioni sulla norma di corrispondenza della risorsa, che YouTube applica ai video caricati dagli utenti che corrispondono alla risorsa.

timeCreated

string

La data e l'ora di creazione della risorsa. Il valore è specificato nel formato 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)

L'oggetto ownershipConflicts contiene informazioni sui conflitti di proprietà della risorsa.

id

string

Un ID assegnato e utilizzato da YouTube per identificare in modo univoco la risorsa.

aliasId[]

string

Un elenco di ID risorsa che possono essere utilizzati per fare riferimento alla risorsa. L'elenco contiene valori se la risorsa rappresenta più risorse che sono state unite. In questo caso, qualsiasi ID risorsa assegnato in origine alle risorse costituenti potrebbe essere utilizzato per aggiornare la risorsa principale, o sintetizzata,

label[]

string

Un elenco di etichette sulla risorsa.

licensability

object (AssetLicensability)

Informazioni sull'idoneità alla concessione in licenza delle risorse.

nWayRevenueSharing

object (NWayRevenueSharing)

Informazioni sulla condivisione delle entrate in modalità N (Pangea).

OwnershipConflicts

La risorsa ownershipConflicts rappresenta le informazioni sulla proprietà in conflitto della risorsa.

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

object (TerritoryConflicts)

Un elenco che identifica i conflitti di proprietà di una risorsa e i territori in cui è inserita la proprietà in conflitto.

performance[]

object (TerritoryConflicts)

Un elenco che identifica i conflitti di proprietà dei diritti di esecuzione per una risorsa di composizione e i territori in cui è inserita la proprietà in conflitto.

synchronization[]

object (TerritoryConflicts)

Un elenco che identifica i conflitti di proprietà dei diritti di sincronizzazione per una risorsa di composizione e i territori in cui è inserita la proprietà in conflitto.

mechanical[]

object (TerritoryConflicts)

Un elenco che identifica i conflitti di proprietà dei diritti meccanici di una risorsa di composizione e i territori in cui è inserita la proprietà in conflitto.

kind

string

Il tipo di risorsa API. Per ownershipConflicts risorse, il valore è youtubePartner#ownershipConflicts.

TerritoryConflicts

Metodo per indagare sugli atti terroristici con conflitti di proprietà.

Rappresentazione JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
Campi
territory

string

Un territorio in cui è presente il conflitto di proprietà. Il territorio è un codice paese ISO 3166 di due lettere.

conflictingOwnership[]

object (ConflictingOwnership)

Un elenco di proprietà in conflitto.

ConflictingOwnership

Rappresenta le informazioni relative a una proprietà in conflitto.

Rappresentazione JSON
{
  "ratio": number,
  "owner": string
}
Campi
ratio

number

La percentuale della risorsa controllata o amministrata dal proprietario.

owner

string

L'ID del proprietario della risorsa in conflitto.

AssetLicensability

Informazioni sull'idoneità alla concessione in licenza delle risorse.

Rappresentazione JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
Campi
licensable

boolean

Se la risorsa riconciliata può essere concessa in licenza.

licensabilityState

string

Lo stato cedibile in licenza della risorsa.

unlicensableReason[]

string

Il motivo per cui la risorsa non è cedibile in licenza.

NWayRevenueSharing

Quota di condivisione delle entrate in entrata della risorsa di informazioni.

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

string

Stato della condivisione delle entrate in-way.

eligibleTerritories[]

string

Ogni paese è rappresentato dal codice paese ISO a due lettere (ISO 3166-1 alpha-2).

ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

Informazioni sui periodi in cui una risorsa non è idonea per la condivisione delle entrate in entrata.

TerritoriesIneligibleForNWayRevenueSharing

Informazioni sui territori in cui una risorsa non è idonea per la quota di condivisione delle entrate n-way.

Rappresentazione JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
Campi
reason

string

Motivo di non idoneità per i problemi elencati di seguito.

territories[]

string

Ogni paese è rappresentato dal codice paese ISO a due lettere (ISO 3166-1 alpha-2).

Metodi

get

Recupera i metadati per la risorsa specificata.

insert

Inserisce una risorsa con i metadati specificati.

list

Recupera un elenco di risorse in base ai relativi metadati.

patch

Applica patch ai metadati per la risorsa specificata.

update

Consente di aggiornare i metadati della risorsa specificata.