SDF را دانلود کنید

هنگامی که عملیات شما با موفقیت به پایان رسید و نام منبع را از پاسخ عملیات تکمیل شده استخراج کردید، آماده دانلود فایل فشرده حاوی SDF های تولید شده خود با استفاده از روش media.download هستید.

توجه: باید فرمت داده را برای پاسخ دانلود خود به عنوان media از طریق پارامتر alt مشخص کنید. این را می توان با افزودن ?alt=media به آدرس اینترنتی دانلود خود انجام داد. کتابخانه های مشتری از این موضوع برای شما مراقبت می کنند.

در اینجا مثالی از نحوه استفاده از کتابخانه مشتری برای دانلود فایل حاصل آورده شده است:

جاوا

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

پایتون

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

هنگامی که فایل شما دانلود و از حالت فشرده خارج شد، فایل های داده های ساخت یافته تولید شده شما در دسترس شما خواهند بود. فایل های تولید شده دارای نام های عمومی هستند که نوع فایل SDF را مشخص می کند (مثال: SDF-LineItems.csv ).

فایل های رد شده

اگر داده‌های منبع درخواستی را نمی‌توان در فایل داده ساختاریافته مربوطه گنجاند، فایل فشرده دانلود شده ممکن است شامل یک فایل "Skipped" باشد (مثال: SDF-LineItems-Skipped.csv ). این فایل دارای ساختار دو ستونی خواهد بود که اولی حاوی شناسه منابعی است که نمی توانند وارد شوند و دومی حاوی دلیل حذف آنهاست.

منابع ممکن است به دلایل زیادی نادیده گرفته شوند، از جمله اینکه در حالت پشتیبانی نشده یا از نوع پشتیبانی نشده هستند. با استفاده از جدیدترین نسخه SDF از حذف منابع خودداری کنید.