Faça o download do SDF

Depois que a operação for concluída e você extrair o nome do recurso da resposta da operação concluída, você poderá fazer o download do arquivo zip que contém os SDFs gerados usando o método media.download.

Observação: especifique o formato de dados da resposta de download como media usando o parâmetro alt. Para fazer isso, adicione ?alt=media ao URL de download. As bibliotecas de cliente cuidam disso para você.

Confira um exemplo de como usar uma biblioteca de cliente para fazer o download do arquivo resultante:

Java

// Extract download file resource name to use in download request
String downloadResourceName = operationResponse.getResponse()
    .get("resourceName").toString();

// Configure the Media.download request
Media.Download downloadRequest =
   service
       .media()
       .download(downloadResourceName);

// Create output stream for downloaded file
FileOutputStream outStream =
   new FileOutputStream(output-file);

// Download file
downloadRequest.executeMediaAndDownloadTo(outStream);

System.out.printf("File downloaded to %s\n", outputFile);

Python

# Extract download file resource name to use in download request
resourceName = operation["response"]["resourceName"]

# Configure the Media.download request
downloadRequest = service.media().download_media(resourceName=resourceName)

# Create output stream for downloaded file
outStream = io.FileIO(output-file, mode='wb')

# Make downloader object
downloader = googleHttp.MediaIoBaseDownload(outStream, downloadRequest)

# Download media file in chunks until finished
download_finished = False
while download_finished is False:
  _, download_finished = downloader.next_chunk()

print("File downloaded to %s" % output-file)

PHP

// Get client and set defer so it doesn't immediately return.
$client = $this->service->getClient();
$client->setDefer(true);

// Build media download request.
$request = $this->service->media->download(
    $operation->getResponse()['resourceName'],
    array('alt' => 'media')
);

// Call the API, getting the generated SDF.
$response = $client->execute($request);
$responseBody = $response->getBody();

// Writes the downloaded file. If the file already exists, it is
// overwritten.
file_put_contents(output-file, $responseBody);
$client->setDefer(false);

printf('File saved to: %s\n', output-file);

Depois que o arquivo for baixado e descompactado, os arquivos de dados estruturados gerados vão ficar disponíveis. Os arquivos gerados terão nomes genéricos que identificam o tipo de arquivo SDF (exemplo: SDF-LineItems.csv).

Arquivos ignorados

Se os dados de um recurso solicitado não puderem ser incluídos no arquivo de dados estruturados correspondente, o arquivo ZIP baixado poderá incluir um arquivo "Omitido" (exemplo: SDF-LineItems-Skipped.csv). Esse arquivo terá uma estrutura de duas colunas, sendo que a primeira contém os IDs dos recursos que não puderam ser incluídos e a segunda contém o motivo da exclusão.

Os recursos podem ser ignorados por vários motivos, incluindo estar em um estado sem suporte ou de um tipo não aceito. Evite que os recursos sejam ignorados usando a versão mais recente do SDF.