تنزيل الملف

بعد انتهاء عملية إنشاء ملفات البيانات المنظَّمة بنجاح، نزِّل ملف ZIP الناتج من موقع المرجع المقدَّم باستخدام media.download.

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

في ما يلي كيفية استرداد موقع الملف وتنزيل ملف ZIP:

# 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(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}.')

استخراج الملفات

فك ضغط ملف ZIP الذي تم تنزيله لاستخراج ملفات البيانات المنظَّمة التي تم إنشاؤها. وتتضمّن أسماءً عامة تحدّد نوع الملف، مثل SDF-LineItems.csv.

إذا تعذّر تضمين بيانات خاصة بمورد مطلوب في ملف البيانات المنظَّمة الذي تم إنشاؤه، سيتضمّن ملف ZIP أيضًا ملفًا بعنوان "تم تخطّيه" خاصًا بهذا المورد، مثل SDF-LineItems-Skipped.csv. تتضمّن الملفات التي تم "تخطّيها" بنية من عمودَين. يحدّد العمود الأول المرجع الذي تم تخطّيه، ويحتوي العمود الثاني على رسالة الخطأ التي توضّح سبب استبعاده.