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 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ể Google Ads thực tế.

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ã nhận dạng 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 có 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: mã 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.

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

Khi xử lý một yêu cầu thay đổi tài nguyên có nhiều thao tác, đôi khi bạn sẽ cần sử dụng mã 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 của API. Mã 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 thay đổi tài nguyên. Để sử dụng mã tạm thời một cách hiệu quả, bạn sẽ phải viết một số mã để đảm bảo rằng bạn không tạo mã 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 liên tiếp đến getNextTempId sẽ trả về một số nhỏ hơn số trước đó. 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.

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