İşleminiz başarıyla tamamlandıktan ve tamamlanan işlem yanıtından kaynak adını çıkardıktan sonra, oluşturulan SDF'lerinizi içeren zip dosyasını media.download
yöntemini kullanarak indirmeye hazır olursunuz.
Aşağıda, sonuç dosyasını indirmek için istemci kitaplığının nasıl kullanılacağına dair bir örnek verilmiştir:
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);
Dosyanız indirilip sıkıştırılmış dosya açıldıktan sonra, oluşturulan yapılandırılmış veri dosyalarınızı kullanabilirsiniz. Oluşturulan dosyalar, SDF dosya türünü tanımlayan genel adlara sahip olur (örnek: SDF-LineItems.csv
).
Atlanan dosyalar
İstenen kaynağın verileri, karşılık gelen yapılandırılmış veri dosyasına eklenemiyorsa indirilen zip dosyası bir "Atlandı" dosyası (örnek: SDF-LineItems-Skipped.csv
) içerebilir. Bu dosya, iki sütunlu bir yapıya sahip olur. Bu yapıda ilki dahil edilemeyen kaynakların kimliklerini, ikincisi ise hariç tutma nedenini içerir.
Kaynaklar, desteklenmeyen bir durumda veya desteklenmeyen türde olmak gibi birçok nedenden dolayı atlanabilir. SDF'nin en son sürümünü kullanarak kaynakları atlamayın.