تنزيل أداة SDF

بعد انتهاء العملية بنجاح واستخراج المورد من استجابة العملية المكتملة، تكون جاهزًا لتنزيل الملف المضغوط يحتوي على ملفات SDF التي تم إنشاؤها باستخدام media.download .

ملاحظة: يجب تحديد تنسيق البيانات لاستجابة التنزيل على أنّه media من خلال المعلمة alt. يمكن إجراء ذلك من خلال إلحاق ?alt=media بـ تنزيل عنوان url. وتتولى مكتبات العملاء هذا الأمر نيابةً عنك.

إليك مثال على كيفية استخدام مكتبة برامج لتنزيل الملف الناتج:

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 (مثال: SDF-LineItems.csv)

الملفات التي تم تخطّيها

إذا تعذّر تضمين بيانات المورد المطلوب في ملف بيانات منظمة، قد يتضمن الملف المضغوط الذي تم تنزيله ملف "تم تخطيه" الملف (مثال: SDF-LineItems-Skipped.csv) سيحتوي هذا الملف على عمودين البيانات الأولى التي تحتوي على معرّفات الموارد التي يتعذر والسبب الثاني الذي يحتوي على سبب استبعادهم.

قد يتم تخطّي الموارد لعدة أسباب، بما في ذلك عدم توافقها مع المحتوى. الحالة أو نوعها غير متوافق. تجنب تخطي الموارد باستخدام أحدث إصدار من SDF.