Aujourd’hui, je vais partager avec vous un petit bout de code en PHP concernant les libellés Adwords.

Comme vous le savez, les libellés ont des noms et id uniques. De plus, les noms des libellés sont sensibles à la casse.
Avant d’appliquer un libellé à n’importe quel élément (campagne, groupe, annonce, mot-clé), il faut d’abord vérifier si le libellé a déjà été créé dans le compte (getlabels.php)

S’il n’existe pas encore, on doit le créer.
D’ailleurs, Google explique déjà très bien le process 

Create labels with Adwords API

You create labels using a TextLabel object. To create a TextLabel:

  • Create a TextLabel object.
  • Set its name.
  • Wrap the TextLabel in a LabelOperation and send it to LabelService.mutate().

You’ll need the IDs of the new labels for the next steps, so make sure you capture them from the mutate call’s response, or use LabelService.get() or LabelService.query() to retrieve the IDs.

Voici le code PHP correspondant :


$labelService = $adWordsServices->get($session, LabelService::class);
$label_name = "toto";//modifiez le nom du libellé ici
$textLabel = new TextLabel();
$textLabel->setName($label_name);
$labelOperation = new LabelOperation();
$labelOperation->setOperand($textLabel);
$labelOperation->setOperator(Operator::ADD);
$labelOperations[] = $labelOperation;
$result = $labelService->mutate($labelOperations);
foreach ($result->getValue() as $label) {
printf("Label with name '%s' and ID %d was added.\n",
$label->getName(),
$label->getId()
);
$label_id = $label->getId();
}

 

Après la création du libellé, on récupère l’ID de celui-ci ($label_id) et on l’applique à l’élément qu’on veut (campagne, groupe, annonce, mot-clé).
Attention : on utilise ici le LabelService (niveau compte) et non AccountLabelService (niveau MCC).