Utiliser des ID temporaires

Une fonctionnalité puissante de BatchJobService est qu'elle permet d'utiliser des ID temporaires.

Pour ce faire, spécifiez le resource_name de la nouvelle ressource afin d'utiliser un ID négatif. Par exemple, supposons que vous créez une campagne et que vous spécifiez son nom de ressource comme customers/<YOUR_CUSTOMER_ID>/campaigns/-1. Lorsque vous créerez le groupe d'annonces dans une opération ultérieure, vous pourrez y faire référence par ce nom de ressource. L'-1 que vous avez spécifié sera alors automatiquement remplacé par l'ID réel de la campagne créée.

Voici quelques éléments à retenir lorsque vous utilisez des noms de ressources temporaires :

• Un nom de ressource temporaire ne peut être utilisé qu'après avoir été défini dans une ressource. Dans l'exemple suivant, l'opération du groupe d'annonces doit figurer après l'opération de la campagne dans la liste des opérations.
• Les noms de ressources temporaires ne sont pas conservés d'une tâche ou d'une requête de mutation à l'autre. Pour référencer une ressource créée dans une requête de mutation ou un job précédent, utilisez son nom de ressource réel.
• Pour une seule requête de tâche ou de mutation, chaque nom de ressource temporaire doit utiliser un nombre négatif unique, même s'ils proviennent de différents types de ressources. Si un ID temporaire est réutilisé dans une même tâche ou requête de mutation, une erreur est renvoyée.

Exemple

Supposons que vous souhaitiez ajouter une campagne, un groupe d'annonces et une annonce dans une seule requête API. Vous devez créer une structure pour votre requête analogue à la suivante :

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

Un nouvel ID temporaire est utilisé pour le groupe d'annonces, car nous ne pouvons pas réutiliser le -1 que nous avons utilisé pour la campagne. Nous faisons également référence à ce groupe d'annonces lorsque nous créons une annonce de groupe d'annonces. Le groupe d'annonces lui-même fait référence au nom de ressource que nous avons établi pour la campagne dans une opération précédente de la requête, tandis que resource_name dans ad_group_ad_operation n'est pas nécessaire, car aucune autre opération ne le référence.