Kimlikler

Çoğu Google Ads öğesi, tanımlayıcılarını döndüren bir getId() yöntemi sunar. Çoğu durumda kesinlikle gerekli olmasa da kimlikler,

Raporlarla çalışma
Kimlikler, rapor satırını gerçek Google Ads öğesine bağlamanın iyi bir yoludur.
Harici bir veri deposuyla eşlemeyi sürdürme
Kendi veritabanınızda kimliğe dayalı bilgiler depoluyor olabilirsiniz.
Performans artışı arayışı

Kimliklere göre getirme işlemi genellikle alternatiflere göre daha hızlıdır. Tek bir öğeyi getirme kodu da biraz daha kolaydır:

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// versus
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

Benzersizlik

Kampanya kimlikleri ve reklam grubu kimlikleri benzersizdir: İki kampanya veya reklam grubu hiçbir zaman aynı kimliği paylaşmaz. Ancak reklamlar ve anahtar kelimeler bileşik kimliklere sahiptir: Bir anahtar kelimenin benzersiz tanımlayıcısı, reklam grubu kimliği ve anahtar kelime kimliğinin birleşimidir. Benzer şekilde, bir reklamın benzersiz tanımlayıcısı, reklam grubu kimliği ve reklam kimliğinin birleşimidir. Bu durum, selector.withIds() öğesinin çağrılma şeklini etkiler.

Kampanyalar ve reklam grupları için selector.withIds() bir sayı dizisi bekler:

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

Ancak reklamlar ve anahtar kelimeler için selector.withIds(), ilk öğesi reklam grubu kimliği olan iki öğeli dizilerden oluşan bir dizi gerektirir. Aşağıdaki snippet, bir reklam grubundan üç anahtar kelime alır:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

Reklamlar getirilirken de aynı yapı geçerlidir.

Geçici ID'ler

Birden fazla işlem içeren bir değişiklik isteğiyle çalışırken, API yanıtını alana kadar tam kaynak adları kullanılamayacağından kaynakları birbirine bağlamak için zaman zaman geçici ID'ler kullanmanız gerekir. Geçici ID'ler, -1 ile başlayan negatif sayılar olmalı ve aynı değişiklik isteğinde tekrarlanmamalıdır. Geçici ID'leri etkili bir şekilde kullanmak için yinelenen geçici ID'ler oluşturmadığınızdan emin olmak üzere bazı kodlar yazmanız gerekir:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

getNextTempId işlevine yapılan her ardışık çağrı, bir öncekinden bir eksik sayı döndürür. Tüm geçici kimlikler negatif olmalıdır. Bu nedenle -1'den başlayın.

Geçici ID'ler, işler veya değişiklik istekleri arasında hatırlanmaz. Önceki bir değişiklik isteğinde oluşturulan bir kaynağa referans vermek için kaynağın gerçek adını kullanın.