دریافت فایل

پس از اینکه تولید فایل‌های داده ساختاریافته با موفقیت به پایان رسید، فایل ZIP حاصل را با استفاده از media.download از محل منبع ارائه شده دانلود کنید.

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

در اینجا نحوه بازیابی محل فایل و دانلود فایل 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 شامل یک فایل "Skipped" برای آن منبع نیز خواهد بود، مانند SDF-LineItems-Skipped.csv . فایل‌های "Skipped" ساختار دو ستونی دارند. ستون اول منبع نادیده گرفته شده را مشخص می‌کند و ستون دوم حاوی پیام خطایی است که حذف آنها را توضیح می‌دهد.