SDF herunterladen

Sobald der Vorgang erfolgreich abgeschlossen ist und Sie die Ressource extrahiert haben aus der abgeschlossenen Vorgangsantwort enthält, können Sie die ZIP-Datei mit den erstellten strukturierten Datendateien mithilfe von media.download .

Hier ist ein Beispiel für die Verwendung einer Clientbibliothek zum Herunterladen der resultierenden Datei:

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

Nachdem Sie die Datei heruntergeladen und entpackt haben, zur Verfügung stehen. Die generierten Dateien haben generische Namen zur Identifizierung des SDF-Dateityps (Beispiel: SDF-LineItems.csv).

Übersprungene Dateien

Wenn Daten für eine angeforderte Ressource nicht in der entsprechenden strukturierte Datendatei enthält, kann die heruntergeladene ZIP-Datei Datei (Beispiel: SDF-LineItems-Skipped.csv). Diese Datei hat eine zweispaltige Struktur, wobei die erste die IDs der Ressourcen enthält, und die zweite den Grund für den Ausschluss enthält.

Ressourcen können aus vielen Gründen übersprungen werden, z. B. weil sie sich in einer nicht unterstützten Status oder eines nicht unterstützten Typs vorliegen. Vermeiden Sie das Überspringen von Ressourcen mithilfe der der aktuellen SDF-Version.