Method: sdfdownloadtasks.create

Crea un'attività di download dell'SDF. Restituisce un Operation.

Un'attività di download SDF è un'operazione asincrona a lunga esecuzione. Il tipo metadata di questa operazione è SdfDownloadTaskMetadata. Se la richiesta ha esito positivo, il tipo dell'operazione response è SdfDownloadTask. La risposta non includerà i file di download, che devono essere recuperati con media.download. Lo stato dell'operazione può essere recuperato con sdfdownloadtask.operations.get.

Sono disponibili eventuali errori in error.message. Tieni presente che il campo error.details dovrebbe essere vuoto.

Richiesta HTTP

POST https://displayvideo.googleapis.com/v2/sdfdownloadtasks

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "version": enum (SdfVersion),

  // Union field root_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field root_id.

  // Union field filtering_option can be only one of the following:
  "parentEntityFilter": {
    object (ParentEntityFilter)
  },
  "idFilter": {
    object (IdFilter)
  },
  "inventorySourceFilter": {
    object (InventorySourceFilter)
  }
  // End of list of possible types for union field filtering_option.
}
Campi
version

enum (SdfVersion)

obbligatorio. La versione SDF del file scaricato. Se impostato su SDF_VERSION_UNSPECIFIED, verrà utilizzata per impostazione predefinita la versione specificata dall'inserzionista o dal partner identificato da root_id. Un inserzionista eredita la versione dell'SDF dal partner, se non diversamente configurato.
Campo di unione root_id. obbligatorio. L'ID radice determina il contesto della richiesta di download. Deve essere impostato esattamente un campo. root_id può essere solo uno dei seguenti:
partnerId

string (int64 format)

L'ID del partner per cui scaricare l'SDF.
advertiserId

string (int64 format)

L'ID dell'inserzionista per cui scaricare il file SDF.
Campo di unione filtering_option. obbligatorio. Opzioni che specificano i tipi di entità e gli intervalli da scaricare. Deve essere impostato esattamente un campo. filtering_option può essere solo uno dei seguenti:
parentEntityFilter

object (ParentEntityFilter)

Filtri sui tipi di file selezionati. Le entità in ogni file vengono filtrate in base a un insieme selezionato di entità di filtro. Le entità del filtro devono essere dello stesso tipo o del tipo padre dei tipi di file selezionati.
idFilter

object (IdFilter)

Filtri sulle entità in base ai relativi ID entità.
inventorySourceFilter

object (InventorySourceFilter)

Filtri sulle origini dell'inventario in base ai relativi ID.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation appena creata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/display-video

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

ParentEntityFilter

Un'opzione di filtro che filtra in base a tipi di file selezionati appartenenti a un insieme scelto di entità di filtro.

Rappresentazione JSON 
{
  "fileType": [
    enum (FileType)
  ],
  "filterType": enum (FilterType),
  "filterIds": [
    string
  ]
}
Campi
fileType[]

enum (FileType)

obbligatorio. Tipi di file che verranno restituiti.
filterType

enum (FilterType)

obbligatorio. Tipo di filtro utilizzato per filtrare le entità recuperate.
filterIds[]

string (int64 format)

Gli ID del tipo di filtro specificato. Viene utilizzato per filtrare le entità da recuperare. Se il tipo di filtro non è FILTER_TYPE_NONE, è necessario specificare almeno un ID.

FileType

Possibili tipi di file che possono essere scaricati.

Enum
FILE_TYPE_UNSPECIFIED Valore predefinito quando il tipo non è specificato o è sconosciuto in questa versione.
FILE_TYPE_CAMPAIGN campagna.
FILE_TYPE_MEDIA_PRODUCT Prodotto multimediale.
FILE_TYPE_INSERTION_ORDER Ordine di inserzione.
FILE_TYPE_LINE_ITEM Elemento pubblicitario.
FILE_TYPE_AD_GROUP Gruppo di annunci di YouTube.
FILE_TYPE_AD Annuncio di YouTube.

FilterType

Tipi possibili che possono essere filtrati in base a questi.

Enum
FILTER_TYPE_UNSPECIFIED Valore predefinito quando il tipo non è specificato o è sconosciuto in questa versione.
FILTER_TYPE_NONE Se selezioni questa opzione, non verrà applicato alcun filtro al download. Può essere utilizzato solo se un Advertiser è specificato in CreateSdfDownloadTaskRequest.
FILTER_TYPE_ADVERTISER_ID ID inserzionista. Se selezioni questa opzione, tutti gli ID filtro devono essere ID inserzionista appartenenti al Partner specificato in CreateSdfDownloadTaskRequest.
FILTER_TYPE_CAMPAIGN_ID ID campagna. Se selezioni questa opzione, tutti gli ID filtro devono essere ID campagna che appartengono al criterio Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
FILTER_TYPE_MEDIA_PRODUCT_ID ID prodotto multimediale. Se selezioni questa opzione, tutti gli ID filtro devono essere ID prodotto multimediale che appartengono al criterio Advertiser o Partner specificato in CreateSdfDownloadTaskRequest. Può essere utilizzato solo per scaricare FILE_TYPE_MEDIA_PRODUCT.
FILTER_TYPE_INSERTION_ORDER_ID ID ordine di inserzione. Se selezioni questa opzione, tutti gli ID filtro devono essere ID ordine di inserzione che appartengono al criterio Advertiser o Partner specificato in CreateSdfDownloadTaskRequest. Può essere utilizzato solo per scaricare FILE_TYPE_INSERTION_ORDER, FILE_TYPE_LINE_ITEM, FILE_TYPE_AD_GROUP e FILE_TYPE_AD.
FILTER_TYPE_LINE_ITEM_ID ID elemento pubblicitario. Se selezioni questa opzione, tutti gli ID filtro devono essere ID elemento pubblicitario che appartengono al criterio Advertiser o Partner specificato in CreateSdfDownloadTaskRequest. Può essere utilizzato solo per scaricare FILE_TYPE_LINE_ITEM, FILE_TYPE_AD_GROUP e FILE_TYPE_AD.

IdFilter

Un'opzione di filtro che filtra le entità in base ai relativi ID.

Rappresentazione JSON 
{
  "campaignIds": [
    string
  ],
  "mediaProductIds": [
    string
  ],
  "insertionOrderIds": [
    string
  ],
  "lineItemIds": [
    string
  ],
  "adGroupIds": [
    string
  ],
  "adGroupAdIds": [
    string
  ]
}
Campi
campaignIds[]

string (int64 format)

Campagne da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
mediaProductIds[]

string (int64 format)

Prodotti multimediali da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
insertionOrderIds[]

string (int64 format)

Ordini di inserzione da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
lineItemIds[]

string (int64 format)

Elementi pubblicitari da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
adGroupIds[]

string (int64 format)

Gruppi di annunci di YouTube da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.
adGroupAdIds[]

string (int64 format)

Annunci di YouTube da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest.

InventorySourceFilter

Un'opzione di filtro in base alle entità Origine dell'inventario.

Rappresentazione JSON 
{
  "inventorySourceIds": [
    string
  ]
}
Campi
inventorySourceIds[]

string (int64 format)

Origini dell'inventario da scaricare per ID. Tutti gli ID devono appartenere allo stesso Advertiser o Partner specificato in CreateSdfDownloadTaskRequest. Lascia il campo vuoto per scaricare tutte le origini dell'inventario per l'inserzionista o il partner selezionato.