Criar tarefa de download

Faça uma solicitação sdfdownloadtasks.create para criar uma tarefa de download que gere arquivos de dados estruturados (SDFs).

Defina suas SDFs usando os seguintes campos da solicitação:

  • partnerId ou advertiserId: campos mutuamente exclusivos que definem um recurso principal (parceiro ou anunciante) para os recursos que preenchem os SDFs.
  • version: a versão do SDF a ser usada, se for diferente da padrão definida no nível do parceiro ou anunciante.
  • parentEntityFilter, idFilter ou inventorySourceFilter: campos mutuamente exclusivos que atribuem o filtro usado para especificar os tipos de arquivo e os recursos a serem incluídos.

Use este snippet de código para criar uma tarefa de download de arquivos de dados estruturados de pedido de inserção e item de linha no anunciante especificado e no escopo dos IDs de campanha fornecidos:

# Provide the ID of the parent advertiser of the resources to retrieve.
advertiser_id = advertiser-id

# Provide the Structured Data Files version to download.
sdf_version = sdf-version

# Provide the IDs of the parent campaigns of the resources to retrieve.
campaign_ids = [campaign-id, ...]

# Create the request body.
body = {
  'version': sdf_version,
  'advertiserId': advertiser_id,
  'parentEntityFilter': {
    'fileType': ["FILE_TYPE_INSERTION_ORDER","FILE_TYPE_LINE_ITEM"],
    'filterType': "FILTER_TYPE_CAMPAIGN_ID",
    'filterIds': campaign_ids
  }
}

# Create the operation.
operation = service.sdfdownloadtasks().create(body=body).execute()

# Print resulting operation name.
print(f'Operation {operation["name"]} was created.')