Kimlikler
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Ç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 şu durumlarda faydalı olabilir:
- Raporlarla çalışma
- Kimlikler, bir rapor satırını gerçek Google Ads öğesine bağlamak için iyi bir yöntemdir.
- Harici bir veri deposuyla eşlemeyi sürdürme
- Kendi veritabanınızda kimliğe dayalı bilgiler depoluyor olabilirsiniz.
- Performansı biraz artırmak istiyorsanız
Kimliklere göre getirme işlemi genellikle diğer yöntemlerden daha hızlıdır. Tek bir öğeyi getirme kodu da biraz daha kolaydır:
let campaigns = AdsApp.campaigns()
.withIds([678678])
.get();
// vs.
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 nasıl çağrılacağını etkiler.
Kampanyalar ve reklam grupları için selector.withIds()
sayı dizisi bekler:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Ancak reklamlar ve anahtar kelimeler için selector.withIds()
, iki öğeli dizilerden oluşan bir diziye ihtiyaç duyar. Bu dizilerin ilk öğesi reklam grubu kimliğidir. Aşağıdaki snippet, bir reklam grubundan üç anahtar kelimeyi alır:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
Reklamlar getirilirken de aynı yapı geçerlidir.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-27 UTC."],[[["\u003cp\u003eMost Google Ads entities have a \u003ccode\u003egetId()\u003c/code\u003e method, which returns a unique identifier that can be useful for linking data, improving performance, and referencing external databases.\u003c/p\u003e\n"],["\u003cp\u003eWhen working with reports, IDs can connect report rows to specific Google Ads entities.\u003c/p\u003e\n"],["\u003cp\u003eFetching entities by ID is often faster than using other methods like filtering by name.\u003c/p\u003e\n"],["\u003cp\u003eCampaign and ad group IDs are unique, while ad and keyword IDs are composite, requiring both the ad group ID and their individual ID for unique identification.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eselector.withIds()\u003c/code\u003e method is used to fetch entities by ID, taking an array of numbers for campaigns and ad groups and an array of two-element arrays (ad group ID and entity ID) for ads and keywords.\u003c/p\u003e\n"]]],[],null,["# IDs\n\nMost Google Ads entities expose a `getId()` method that returns their\nidentifier. While not strictly necessary in most cases, IDs may come in handy\nwhen\n\nWorking with [reports](/google-ads/scripts/docs/features/reports)\n: IDs provide a good way to link a report row to the actual Google Ads entity.\n\nMaintaining a mapping with an external data store\n: You may already have ID-based information stored in your own database.\n\nLooking for a bit of a performance boost\n\n: Fetching by IDs is often quicker than alternatives. The code for fetching a\n single entity is a bit easier too:\n\n let campaigns = AdsApp.campaigns()\n .withIds([678678])\n .get();\n // vs.\n let campaigns = AdsApp.campaigns()\n .withCondition(\"Name='My Campaign'\")\n .get();\n\nUniqueness\n----------\n\nCampaign IDs and ad group IDs are unique: no two campaigns or ad groups will\never share the same ID. Ads and keywords, however, have composite IDs: a unique\nidentifier of a keyword is a combination of its ad group ID and keyword ID.\nLikewise, a unique identifier of an ad is a combination of its ad group ID and\nad ID. This has implications for the way `selector.withIds()` is called.\n\nFor campaigns and ad groups, `selector.withIds()` expects an array of numbers: \n\n let ids = [123123, 234234, 345345];\n let campaignSelector = AdsApp.campaigns().withIds(ids);\n\nFor ads and keywords, however, `selector.withIds()` needs an array of\ntwo-element arrays, the first element being the ad group ID. The following\nsnippet retrieves three keywords from an ad group: \n\n let adGroupId = 123123;\n let keywordSelector = AdsApp.keywords().withIds([\n [adGroupId, 234234],\n [adGroupId, 345345],\n [adGroupId, 456456]\n ]);\n\nThe same construct applies when fetching ads."]]