Une fois l'opération terminée et le nom de la ressource extrait de la réponse obtenue, vous pouvez télécharger le fichier ZIP contenant les fichiers SDF générés à l'aide de la méthode media.download.
Voici un exemple d'utilisation d'une bibliothèque cliente pour télécharger le fichier obtenu:
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);
Une fois le fichier téléchargé et décompressé, les fichiers de données structurées générés seront disponibles. Les fichiers générés porteront des noms génériques identifiant le type de fichier SDF (exemple: SDF-LineItems.csv).
Fichiers ignorés
Si les données d'une ressource demandée ne peuvent pas être incluses dans le fichier de données structurées correspondant, le fichier ZIP téléchargé peut inclure un fichier "Ignoré" (exemple: SDF-LineItems-Skipped.csv). Ce fichier est structuré à deux colonnes, la première contenant les ID des ressources qui n'ont pas pu être incluses et la seconde le motif de l'exclusion.
Des ressources peuvent être ignorées pour de nombreuses raisons, y compris si leur état n'est pas compatible ou si leur type n'est pas accepté. Pour éviter que des ressources soient ignorées, utilisez la version la plus récente des fichiers SDF.