SDF herunterladen

Sobald der Vorgang erfolgreich abgeschlossen wurde und Sie den Ressourcennamen aus der abgeschlossenen Vorgangsantwort extrahiert haben, können Sie die ZIP-Datei mit den generierten SDFs mit der Methode media.download herunterladen.

Hier sehen Sie ein Beispiel, wie Sie die resultierende Datei mithilfe einer Clientbibliothek herunterladen:

// 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);

# 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)

// 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);

Nachdem Sie die Datei heruntergeladen und entpackt haben, stehen Ihnen die generierten strukturierten Datendateien zur Verfügung. Die generierten Dateien haben generische Namen, die den SDF-Dateityp identifizieren (z. B. SDF-LineItems.csv).

Übersprungene Dateien

Wenn Daten für eine angeforderte Ressource nicht in der entsprechenden strukturierten Datendatei enthalten sein können, enthält die heruntergeladene ZIP-Datei möglicherweise eine Datei mit dem Text "Übersprungen" (Beispiel: SDF-LineItems-Skipped.csv). Diese Datei hat eine zweispaltige Struktur. Die erste enthält die IDs der Ressourcen, die nicht aufgenommen werden konnten, und die zweite den Grund für den Ausschluss.

Ressourcen können aus verschiedenen Gründen übersprungen werden, z. B. weil sie einen nicht unterstützten Status haben oder einen nicht unterstützten Typ haben. Verwenden Sie die neueste Version der SDF, um Ressourcen zu vermeiden.