Tải SDF xuống

Sau khi hoạt động của bạn hoàn tất thành công và bạn đã trích xuất được tài nguyên tên từ phản hồi thao tác đã hoàn tất, bạn đã sẵn sàng tải xuống tệp zip chứa các SDF đã tạo bằng media.download .

Lưu ý: Bạn phải chỉ định định dạng dữ liệu cho phản hồi tải xuống là media thông qua tham số alt. Bạn có thể thực hiện việc này bằng cách thêm ?alt=media vào URL tải xuống. Thư viện ứng dụng sẽ xử lý vấn đề này cho bạn.

Dưới đây là ví dụ về cách sử dụng thư viện ứng dụng để tải tệp kết quả xuống:

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

Sau khi tải xuống và giải nén tệp, các tệp dữ liệu có cấu trúc mà bạn đã tạo sẽ có cho bạn. Các tệp được tạo sẽ có tên chung xác định loại tệp SDF (ví dụ: SDF-LineItems.csv).

Tệp bị bỏ qua

Nếu dữ liệu cho tài nguyên được yêu cầu không thể được đưa vào trong thuộc tính tệp dữ liệu có cấu trúc, tệp zip tải xuống có thể bao gồm thông báo "Đã bỏ qua" tệp (ví dụ: SDF-LineItems-Skipped.csv). Tệp này sẽ có hai cột cấu trúc này, cấu trúc đầu tiên chứa mã nhận dạng của những tài nguyên không thể và mục thứ hai nêu lý do loại trừ.

Tài nguyên có thể bị bỏ qua vì nhiều lý do, bao gồm cả việc nằm trong một trạng thái hoặc thuộc loại không được hỗ trợ. Tránh để tài nguyên bị bỏ qua bằng cách sử dụng phiên bản mới nhất của SDF.