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:
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, 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.