Télécharger le fichier SDF

Une fois votre opération terminée et que vous avez extrait le nom de la ressource de la réponse de l'opération terminée, vous pouvez télécharger le fichier ZIP contenant les fichiers SDF générés à l'aide de la méthode media.download.

Remarque :Vous devez spécifier le format de données de votre réponse de téléchargement en tant que media via le paramètre alt. Pour ce faire, ajoutez ?alt=media à votre URL de téléchargement. Les bibliothèques clientes s'en chargent pour vous.

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 votre 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 auront des noms génériques identifiant le type de fichier SDF (par 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é" (par exemple, SDF-LineItems-Skipped.csv). Ce fichier aura une structure à deux colonnes, la première contenant les ID des ressources qui n'ont pas pu être incluses et la seconde contenant le motif de leur exclusion.

Les ressources peuvent être ignorées pour de nombreuses raisons, par exemple si elles sont dans un état ou d'un type non compatibles. Évitez que des ressources soient ignorées en utilisant la dernière version de SDF.