生成的结构化数据文件 (SDF) 存储在 ZIP 文件中。使用成功 Operation 的 response.resourceName 字段中的值,通过 media.download 下载此文件。
下载 SDF ZIP 文件的方法如下:
Java
// Provide the name of the finished sdfdownloadtask operation. String operationName = operation-name; // Provide the path for the output file. String outputFile = output-file; // Retrieve the resource location from the finished operation. Operation operation = service.sdfdownloadtasks().operations().get(operationName).execute(); String fileLocation = operation.getResponse().get("resourceName").toString(); // Configure the Media.download request. Media.Download downloadRequest = service.media().download(fileLocation); // Create output stream for downloaded file. FileOutputStream outStream = new FileOutputStream(outputFile); // Download file. downloadRequest.executeMediaAndDownloadTo(outStream); System.out.printf("File downloaded at %s", outputFile);
Python
# Import the object used for media download. from googleapiclient import http as googleHttp # Provide the name of the successfully completed sdfdownloadtask operation. operation_name = operation-name # Provide the path for the output file. output_path = output-path # Retrieve the completed operation. operation = ( service.sdfdownloadtasks().operations().get(name=operation_name).execute() ) # Retrieve the file location from the operation. file_location = operation["response"]["resourceName"] # Configure the media.download request. download_request = service.media().download_media(resourceName=file_location) # Create output stream for downloaded file. out_stream = io.FileIO(output_path, mode="wb") # Build downloader object. downloader = googleHttp.MediaIoBaseDownload(out_stream, download_request) # Download file in chunks until finished. download_finished = False while download_finished is False: _, download_finished = downloader.next_chunk() print(f"File downloaded at {output_path}.")
PHP
// Provide the name of the finished sdfdownloadtask operation. $operationName = operation-name; // Provide the path for the output file. $outputFile = output-file; try { // Call the API, retrieving the SDF Download Task. $operation = $this->service->sdfdownloadtasks_operations->get( $operationName ); $fileLocation = $operation->getResponse()['resourceName']; $client = $this->service->getClient(); $client->setDefer(true); $request = $this->service->media->download( $fileLocation, 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($outputFile, $responseBody); $client->setDefer(false); } catch (\Exception $e) { $this->renderError($e); return; } printf('<p>File downloaded at %s</p>', $outputFile);
提取文件
从 ZIP 文件中提取生成的 SDF。SDF 使用用于标识其类型的通用文件名。订单项 SDF 的名称为 SDF-LineItems.csv。
ZIP 文件可能包含每种文件类型的“已跳过”文件。“跳过”文件用于标识未包含在 SDF 中的资源。它们以 -Skipped 后缀命名。这些文件采用双列结构。第一列用于标识跳过的资源。第二列说明了排除原因。