एसडीएफ़ डाउनलोड करें

कार्रवाई पूरी होने और पूरी कार्रवाई के रिस्पॉन्स से संसाधन का नाम निकालने के बाद, media.download तरीके का इस्तेमाल करके, जनरेट किए गए एसडीएफ़ वाली ZIP फ़ाइल डाउनलोड की जा सकती है.

ध्यान दें: आपको alt पैरामीटर के ज़रिए media के तौर पर अपने डाउनलोड जवाब के लिए डेटा फ़ॉर्मैट तय करना होगा. इसके लिए, आपको अपने डाउनलोड यूआरएल में ?alt=media जोड़ना होगा. क्लाइंट लाइब्रेरी से यह काम हो जाता है.

इस उदाहरण में बताया गया है कि नतीजे के तौर पर बनने वाली फ़ाइल को डाउनलोड करने के लिए, क्लाइंट लाइब्रेरी का इस्तेमाल कैसे किया जाता है:

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

फ़ाइल डाउनलोड और अनज़िप होने के बाद, जनरेट की गई स्ट्रक्चर्ड डेटा फ़ाइलें आपके लिए उपलब्ध होंगी. जनरेट की गई फ़ाइलों के नाम ऐसे होंगे जो एसडीएफ़ फ़ाइल टाइप (उदाहरण: SDF-LineItems.csv) को दिखाने वाले जेनरिक नाम होंगे.

छोड़ी गई फ़ाइलें

अगर अनुरोध किए गए संसाधन का डेटा, उससे जुड़ी स्ट्रक्चर्ड डेटा फ़ाइल में शामिल नहीं किया जा सकता, तो डाउनलोड की गई ZIP फ़ाइल में "स्किप की गई" फ़ाइल शामिल हो सकती है (उदाहरण: SDF-LineItems-Skipped.csv). इस फ़ाइल में दो कॉलम वाले स्ट्रक्चर होंगे. पहली फ़ाइल में उन संसाधनों के आईडी होंगे जो शामिल नहीं किए जा सके. दूसरे में, उन्हें शामिल न करने की वजह बताई गई होगी.

संसाधन काम न करने की कई वजहें हो सकती हैं. इनमें, संसाधनों के काम न करने वाली स्थिति या काम न करने वाले प्रकार का होना भी शामिल है. एसडीएफ़ के सबसे नए वर्शन का इस्तेमाल करके संसाधनों को स्किप करने से बचें.