ID

Sebagian besar entitas Google Ads mengekspos metode getId() yang menampilkan ID-nya. Meskipun tidak mutlak diperlukan dalam sebagian besar kasus, ID dapat berguna saat

Bekerja dengan laporan
ID memberikan cara yang baik untuk menautkan baris laporan ke entitas Google Ads yang sebenarnya.
Mempertahankan pemetaan dengan penyimpanan data eksternal
Anda mungkin sudah memiliki informasi berbasis ID yang disimpan di database Anda sendiri.
Mencari sedikit peningkatan performa

Pengambilan menurut ID sering kali lebih cepat daripada alternatif lainnya. Kode untuk mengambil satu entitas juga sedikit lebih mudah:

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

Keunikan

ID kampanye dan ID grup iklan bersifat unik: tidak ada dua kampanye atau grup iklan yang akan pernah memiliki ID yang sama. Namun, iklan dan kata kunci memiliki ID gabungan: ID unik kata kunci adalah kombinasi dari ID grup iklan dan ID kata kuncinya. Demikian pula, ID unik iklan adalah kombinasi dari ID grup iklan dan ID iklan. Hal ini berdampak pada cara selector.withIds() dipanggil.

Untuk kampanye dan grup iklan, selector.withIds() mengharapkan array angka:

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

Namun, untuk iklan dan kata kunci, selector.withIds() memerlukan array array dua elemen, dengan elemen pertama adalah ID grup iklan. Cuplikan berikut mengambil tiga kata kunci dari grup iklan:

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

Konstruksi yang sama berlaku saat mengambil iklan.

ID sementara

Saat bekerja dengan permintaan mutasi dengan beberapa operasi, terkadang Anda perlu menggunakan ID sementara untuk menautkan satu sama lain, karena nama lengkap resource tidak akan tersedia hingga Anda mendapatkan respons API. ID sementara harus berupa angka negatif yang dimulai dengan -1, dan tidak boleh berulang dalam permintaan perubahan yang sama. Untuk menggunakan ID sementara secara efektif, Anda harus menulis beberapa kode untuk memastikan bahwa Anda tidak membuat ID sementara duplikat:

let nextId = -1;

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

Setiap panggilan berikutnya ke getNextTempId akan menampilkan angka yang lebih kecil satu dari sebelumnya. Karena semua ID sementara harus negatif, mulai dari -1.

ID sementara tidak diingat di seluruh tugas atau permintaan mutasi. Untuk mereferensikan resource yang dibuat dalam permintaan perubahan sebelumnya, gunakan nama resource sebenarnya.