ID

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 thực thể đó. 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 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();
// versus
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 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.

Mã nhận dạng tạm thời

Khi làm việc với một yêu cầu biến đổi có nhiều thao tác, đôi khi bạn sẽ cần sử dụng mã nhận dạng tạm thời để liên kết các tài nguyên với nhau, vì tên tài nguyên đầy đủ sẽ không có sẵn cho đến khi bạn nhận được phản hồi API. Mã nhận dạng tạm thời phải là số âm bắt đầu bằng -1 và không được lặp lại trong cùng một yêu cầu biến đổi. Để sử dụng mã nhận dạng tạm thời một cách hiệu quả, bạn phải viết một số mã để đảm bảo rằng bạn không tạo mã nhận dạng tạm thời trùng lặp:

let nextId = -1;

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

Mỗi lệnh gọi tiếp theo đến getNextTempId sẽ trả về một số nhỏ hơn số trước đó một đơn vị. Vì tất cả mã nhận dạng tạm thời đều phải là số âm, nên hãy bắt đầu từ -1.

Các mã nhận dạng tạm thời không được ghi nhớ trên các yêu cầu về công việc hoặc yêu cầu biến đổi. Để tham chiếu đến một tài nguyên được tạo trong yêu cầu biến đổi trước đó, hãy sử dụng tên tài nguyên thực tế của tài nguyên đó.