הורדת ה-SDF

אחרי שהפעולה הסתיימה בהצלחה וחילצת את המשאב מהתגובה של הפעולה שהושלמה, אפשר להוריד את קובץ ה-ZIP שמכיל את קובצי ה-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).

קבצים שדילגת עליהם

אם לא ניתן לכלול נתונים של משאב מבוקש של קובץ נתונים מובְנים, קובץ ה-ZIP שירד עשוי לכלול את הכיתוב 'דילגת' קובץ (לדוגמה: SDF-LineItems-Skipped.csv). הקובץ הזה יכלול שתי עמודות הוא הראשון שמכיל את המזהים של המשאבים שלא ניתן היה נכללות והשנייה מכילה את הסיבה להחרגה.

המערכת עשויה לדלג על משאבים מסיבות רבות, כולל משאבים שלא נתמכים או מסוג שאינו נתמך. כדי למנוע דילוג על משאבים אפשר להשתמש את הגרסה העדכנית ביותר של SDF.