Method: advertisers.sdfuploadtasks.upload

Cria uma tarefa de upload de SDF. Retorna um Operation.

Uma tarefa de upload de SDF é uma operação assíncrona de longa duração. O tipo metadata dessa operação é SdfUploadTaskMetadata. Se a solicitação for bem-sucedida, o tipo response da operação será SdfUploadTask. A resposta não inclui os arquivos resultantes, que podem ser recuperados usando media.download.

O estado da operação pode ser recuperado com sdfuploadtask.operations.get.

Os erros podem ser encontrados no error.message. error.details precisa estar vazio.

Solicitação HTTP

  • URI de upload, para solicitações de upload de mídia:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI de metadados, para solicitações somente de metadados:
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
advertiserId

string (int64 format)

Obrigatório. O ID do anunciante para fazer o upload do SDF.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
Campos
filename

string

Obrigatório. O nome do arquivo do recurso, incluindo a extensão. O nome do arquivo precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
sdfVersion

enum (SdfVersion)

Obrigatório. A versão SDF do arquivo enviado. Se definido como SDF_VERSION_UNSPECIFIED, o padrão será a versão especificada pelo anunciante identificado. Um anunciante herda a versão do SDF do parceiro, a menos que seja configurado de outra forma.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.