Créer une tâche de téléchargement

Envoyez une requête sdfdownloadtasks.create pour créer une tâche de téléchargement qui génère des fichiers de données structurées.

Définissez vos fichiers SDF à l'aide des champs suivants de votre demande :

• partnerId ou advertiserId : champs mutuellement exclusifs qui définissent une ressource parente (partenaire ou annonceur) pour les ressources qui remplissent les fichiers SDF.
• version : version SDF à utiliser, si elle est différente de celle définie par défaut au niveau du partenaire ou de l'annonceur.
• parentEntityFilter, idFilter ou inventorySourceFilter : champs mutuellement exclusifs qui attribuent le filtre utilisé pour spécifier les types de fichiers et les ressources à inclure.

Utilisez cet extrait de code pour créer une tâche de téléchargement pour les fichiers de données structurées d'ordre d'insertion et d'élément de campagne pour l'annonceur donné et dans le champ d'application des ID de campagne fournis :

Avertissement : Un même utilisateur ne peut exécuter que 20 opérations sdfdownloadtask à la fois. Toute tentative de création d'autres comptes générera une erreur.

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