Scaricare l'SDF

Dopo che l'operazione è stata completata correttamente e hai estratto la risorsa nome dalla risposta dell'operazione completata, puoi scaricare il file ZIP contenente gli SDF generati utilizzando media.download .

Nota: devi specificare il formato dei dati per la risposta al download come media. tramite il parametro alt. Puoi farlo aggiungendo ?alt=media alla tua URL di download. Le librerie client si occupano di eseguire questa operazione per te.

Ecco un esempio di come utilizzare una libreria client per scaricare il file risultante:

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);

Dopo aver scaricato e decompresso il file, i file di dati strutturati generati sarà disponibile per te. I file generati avranno nomi generici identificando il tipo di file SDF (esempio: SDF-LineItems.csv).

File ignorati

Se i dati per una risorsa richiesta non possono essere inclusi nel file di dati strutturati, il file ZIP scaricato potrebbe includere la dicitura "Saltato" file (esempio: SDF-LineItems-Skipped.csv). Questo file avrà un formato a due colonne principale, il primo contenente gli ID delle risorse che non potrebbero essere incluso e il secondo contenente il motivo dell'esclusione.

Le risorse potrebbero essere ignorate per molti motivi, ad esempio il fatto che si trovano in un luogo non supportato o di un tipo non supportato. Per evitare di farti saltare le risorse, utilizza alla versione più recente di SDF.