ID
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hầu hết các thực thể Google Ads đều hiển thị một phương thức getId() trả về giá trị nhận dạng của chúng. Mặc dù không thực sự cần thiết trong hầu hết các trường hợp, nhưng mã nhận dạng có thể hữu ích khi
- Làm việc với báo cáo
- Mã nhận dạng là một cách hiệu quả để liên kết một hàng trong báo cáo với thực thể thực tế trên Google Ads.
- Duy trì mối liên kết với một kho dữ liệu bên ngoài
- Có thể bạn đã lưu trữ thông tin dựa trên mã nhận dạng trong cơ sở dữ liệu của riêng mình.
- Bạn muốn tăng hiệu suất một chút
Việc tìm nạp theo mã thường nhanh hơn các phương thức khác. Mã để tìm nạp một thực thể cũng dễ dàng hơn một chút:
let campaigns = AdsApp.campaigns()
.withIds([678678])
.get();
// vs.
let campaigns = AdsApp.campaigns()
.withCondition("Name='My Campaign'")
.get();
Điểm đặc biệt
Mã chiến dịch và mã nhóm quảng cáo là duy nhất: không có hai chiến dịch hoặc nhóm quảng cáo nào dùng chung cùng một mã. Tuy nhiên, quảng cáo và từ khoá có mã nhận dạng kết hợp: giá trị nhận dạng duy nhất của một từ khoá là sự kết hợp giữa mã nhóm quảng cáo và mã từ khoá.
Tương tự, giá trị nhận dạng riêng biệt của một quảng cáo là sự kết hợp giữa mã nhóm quảng cáo và mã quảng cáo. Điều này ảnh hưởng đến cách gọi selector.withIds().
Đối với chiến dịch và nhóm quảng cáo, selector.withIds() dự kiến sẽ có một mảng các số:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Tuy nhiên, đối với quảng cáo và từ khoá, selector.withIds() cần một mảng gồm các mảng có hai phần tử, phần tử đầu tiên là mã nhóm quảng cáo. Đoạn mã sau đây truy xuất 3 từ khoá từ một nhóm quảng cáo:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
Cấu trúc tương tự cũng áp dụng khi tìm nạp quảng cáo.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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."]]
