Mendownload SDF

Setelah operasi berhasil diselesaikan dan Anda telah mengekstrak aset nama dari respons operasi yang telah selesai, Anda siap untuk mengunduh file zip file yang berisi SDF yang dihasilkan menggunakan media.download .

Catatan: Anda harus menentukan format data untuk respons download sebagai media melalui parameter alt. Hal ini dapat dilakukan dengan menambahkan ?alt=media ke URL download. Library klien menangani hal ini untuk Anda.

Berikut adalah contoh cara menggunakan library klien untuk mendownload file yang dihasilkan:

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

Setelah file didownload dan diekstrak, file data terstruktur yang dihasilkan akan tersedia untuk Anda. File yang dihasilkan akan memiliki nama umum mengidentifikasi jenis file SDF (contoh: SDF-LineItems.csv).

File yang dilewati

Jika data untuk resource yang diminta tidak dapat disertakan dalam file data terstruktur, file ZIP yang didownload mungkin menyertakan pesan "Dilewati" file (contoh: SDF-LineItems-Skipped.csv). File ini akan memiliki dua kolom struktur, yang pertama berisi ID sumber daya yang tidak dapat disertakan dan yang kedua berisi alasan pengecualian mereka.

Resource dapat dilewati karena berbagai alasan, termasuk dalam halaman yang tidak didukung status atau jenisnya tidak didukung. Hindari resource yang dilewati dengan menggunakan versi terbaru SDF.