Télécharger le fichier SDF

Une fois l'opération terminée et la ressource extraite à partir de la réponse de l'opération terminée, vous pouvez télécharger le fichier ZIP contenant les fichiers SDF que vous avez 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 sous la forme 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 le fichier téléchargé et décompressé, les fichiers de données structurées générés sera disponible. 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 la de données structurées, le fichier ZIP téléchargé peut inclure la mention "Skipped" (Ignoré) fichier (exemple: SDF-LineItems-Skipped.csv). Ce fichier contiendra un fichier à deux colonnes structure, la première contenant les identifiants des ressources qui n'ont pas pu être incluses et la seconde indique le motif de leur exclusion.

Les ressources peuvent être ignorées pour de nombreuses raisons, ou dont le type n'est pas pris en charge. Évitez que des ressources soient ignorées en utilisant la la dernière version des fichiers SDF.