La maggior parte delle entità Google Ads espone un metodo getId() che restituisce il proprio identificatore. Sebbene non siano strettamente necessari nella maggior parte dei casi, gli ID possono essere utili
quando
- Utilizzo dei report
- Gli ID sono un buon modo per collegare una riga del report all'entità Google Ads effettiva.
- Gestire una mappatura con un datastore esterno
- Potresti già avere informazioni basate sull'ID memorizzate nel tuo database.
- Cerchi un piccolo aumento delle prestazioni
Il recupero per ID è spesso più rapido rispetto alle alternative. Anche il codice per recuperare una singola entità è un po' più semplice:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // versus let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Unicità
Gli ID campagna e gli ID gruppo di annunci sono univoci: due campagne o gruppi di annunci non
condivideranno mai lo stesso ID. Gli annunci e le parole chiave, tuttavia, hanno ID compositi: un identificatore univoco di una parola chiave è una combinazione del relativo ID gruppo di annunci e ID parola chiave.
Allo stesso modo, un identificatore univoco di un annuncio è una combinazione del suo ID gruppo di annunci e
dell'ID annuncio. Ciò ha implicazioni per il modo in cui viene chiamato selector.withIds().
Per campagne e gruppi di annunci, selector.withIds() prevede un array di numeri:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Per gli annunci e le parole chiave, tuttavia, selector.withIds() richiede un array di
array di due elementi, il primo dei quali è l'ID del gruppo di annunci. Il seguente
snippet recupera tre parole chiave da un gruppo di annunci:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
La stessa struttura si applica quando vengono recuperati gli annunci.
ID temporanei
Quando lavori con una richiesta di modifica con più operazioni, a volte devi utilizzare ID temporanei per collegare le risorse tra loro, poiché i nomi completi delle risorse non saranno disponibili finché non riceverai la risposta API. Gli ID temporanei devono essere numeri negativi che iniziano con -1 e non possono ripetersi all'interno della stessa richiesta di mutazione. Per utilizzare gli ID temporanei in modo efficace, devi scrivere del codice per assicurarti di non creare ID temporanei duplicati:
let nextId = -1;
function getNextTempId() {
const ret = nextId;
nextId -= 1;
return ret;
}
Ogni chiamata successiva a getNextTempId restituirà un numero inferiore di uno rispetto a quello
precedente. Poiché tutti gli ID temporanei devono essere negativi, inizia da -1.
Gli ID temporanei non vengono memorizzati tra job o richieste di mutazione. Per fare riferimento a una risorsa creata in una richiesta di mutazione precedente, utilizza il nome della risorsa effettivo.