Downloadaufgabe erstellen

Stellen Sie einen sdfdownloadtasks.create-Request, um eine Downloadaufgabe zu erstellen, mit der strukturierte Datendateien (SDFs) generiert werden.

Definieren Sie Ihre SDFs mit den folgenden Feldern Ihrer Anfrage:

  • partnerId oder advertiserId: sich gegenseitig ausschließende Felder, die eine übergeordnete Ressource (entweder ein Partner oder ein Werbetreibender) für die Ressourcen definieren, mit denen die SDFs gefüllt werden.
  • version: Die zu verwendende SDF-Version, falls sie sich von der Standardversion unterscheidet, die auf Partner- oder Werbetreibenden-Ebene festgelegt ist.
  • parentEntityFilter, idFilter oder inventorySourceFilter: sich gegenseitig ausschließende Felder, mit denen der Filter zugewiesen wird, der zum Angeben der einzuschließenden Dateitypen und Ressourcen verwendet wird.

Mit diesem Code-Snippet können Sie einen Downloadvorgang für strukturierte Datendateien für Anzeigenaufträge und Werbebuchungen für den angegebenen Werbetreibenden und im Rahmen der angegebenen Kampagnen-IDs erstellen:

# Provide the ID of the parent advertiser of the resources to retrieve.
advertiser_id = advertiser-id

# Provide the Structured Data Files version to download.
sdf_version = sdf-version

# Provide the IDs of the parent campaigns of the resources to retrieve.
campaign_ids = [campaign-id, ...]

# Create the request body.
body = {
  'version': sdf_version,
  'advertiserId': advertiser_id,
  'parentEntityFilter': {
    'fileType': ["FILE_TYPE_INSERTION_ORDER","FILE_TYPE_LINE_ITEM"],
    'filterType': "FILTER_TYPE_CAMPAIGN_ID",
    'filterIds': campaign_ids
  }
}

# Create the operation.
operation = service.sdfdownloadtasks().create(body=body).execute()

# Print resulting operation name.
print(f'Operation {operation["name"]} was created.')
Zurück
Übersicht
Weiter
Umfrageaufgabe