SDF herunterladen

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

Hier ist ein Beispiel dafür, wie Sie mit einer Clientbibliothek die resultierende Datei herunterladen:

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

Sobald die Datei heruntergeladen und entpackt wurde, sind die generierten strukturierten Datendateien verfügbar. Die generierten Dateien haben generische Namen, die den SDF-Dateityp angeben (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 die Datei „Übersprungen“ (Beispiel: SDF-LineItems-Skipped.csv). Diese Datei hat eine zweispaltige Struktur. Die erste Spalte enthält die IDs der Ressourcen, die nicht aufgenommen werden konnten, und die zweite Spalte den Grund für ihren Ausschluss.

Ressourcen können aus vielen Gründen übersprungen werden, z. B. wenn sie sich in einem nicht unterstützten Zustand befinden oder einen nicht unterstützten Typ haben. Verwenden Sie die neueste Version von SDF, um zu vermeiden, dass Ressourcen übersprungen werden.

Zurück
Aufgaben erstellen