Method: lookupByExternalId

Truy xuất tất cả các thực thể theo mã nhận dạng bên ngoài được liệt kê trong yêu cầu.

  • Trả về mã lỗi NOT_FOUND nếu có bất kỳ mã nhận dạng nào không khớp với một tài sản.
  • Trả về mã lỗi FAILED_PRECONDITION nếu tìm thấy nhiều thực thể có cùng mã nhận dạng bên ngoài.

Yêu cầu HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1:lookupByExternalId

URL sử dụng cú pháp Chuyển mã gRPC.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Trường
lineExternalIds[]

string

Các mã nhận dạng bên ngoài để tìm nạp tên từ bảng dòng.
orderExternalIds[]

string

Các mã nhận dạng bên ngoài để tìm nạp tên từ bảng Đơn đặt hàng.
productExternalIds[]

string

Các mã nhận dạng bên ngoài để tìm nạp tên từ bảng Sản phẩm.
adUnitExternalIds[]

string

Các id bên ngoài để tìm nạp tên cho từ bảng đơn vị quảng cáo.
creativeAssetsExternalIds[]

string

Các mã nhận dạng bên ngoài để tìm nạp tên từ bảng CreativeAsset.
assignmentsExternalIds[]

string

Các mã nhận dạng bên ngoài để tìm nạp tên từ bảng Bài tập.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Trường
lines

map (key: string, value: string)

Ánh xạ id bên ngoài đến tên dòng.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Ánh xạ id bên ngoài với tên đơn đặt hàng.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Ánh xạ các mã nhận dạng bên ngoài đến tên sản phẩm.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Liên kết mã nhận dạng bên ngoài đến tên đơn vị quảng cáo.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Liên kết mã nhận dạng bên ngoài với tên thành phần mẫu quảng cáo.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Liên kết mã nhận dạng bên ngoài với tên bài tập.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.