Method: lookupByExternalId

เรียกข้อมูลเอนทิตีทั้งหมดตามรหัสภายนอกที่ระบุไว้ในคำขอ

  • ส่งคืนรหัสข้อผิดพลาด NOT_FOUND หากมีรหัสที่ไม่ตรงกับเนื้อหา
  • ส่งคืนรหัสข้อผิดพลาด FAILED_PRECONDITION หากพบเอนทิตีหลายรายการที่มีรหัสภายนอกเดียวกัน

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
ช่อง
lineExternalIds[]

string

รหัสภายนอกสำหรับดึงข้อมูลชื่อจากตาราง Lines
orderExternalIds[]

string

รหัสภายนอกสำหรับดึงข้อมูลชื่อจากตารางคำสั่งซื้อ
productExternalIds[]

string

รหัสภายนอกที่จะดึงข้อมูลชื่อจากตารางผลิตภัณฑ์
adUnitExternalIds[]

string

รหัสภายนอกที่จะดึงชื่อจากตารางหน่วยโฆษณา
creativeAssetsExternalIds[]

string

รหัสภายนอกสำหรับดึงข้อมูลชื่อจากตารางชิ้นงานครีเอทีฟโฆษณา
assignmentsExternalIds[]

string

รหัสภายนอกสำหรับดึงข้อมูลชื่อจากตาราง Assignments

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
ช่อง
lines

map (key: string, value: string)

แมปของรหัสภายนอกกับชื่อบรรทัด

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
orders

map (key: string, value: string)

แมปของรหัสภายนอกที่จะเรียงลำดับชื่อ

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
products

map (key: string, value: string)

การเชื่อมโยงรหัสภายนอกกับชื่อผลิตภัณฑ์

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
adUnits

map (key: string, value: string)

การแมปรหัสภายนอกกับชื่อหน่วยโฆษณา

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
creativeAssets

map (key: string, value: string)

การแมปรหัสภายนอกกับชื่อชิ้นงานครีเอทีฟโฆษณา

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
assignments

map (key: string, value: string)

การแมปรหัสภายนอกกับชื่องาน

ออบเจ็กต์ที่มีรายการคู่ "key": value ตัวอย่างเช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0