แหล่งข้อมูล: ChromeOsDevice
อุปกรณ์ Google Chrome ทำงานบน Chrome OS ดูข้อมูลเพิ่มเติมเกี่ยวกับงาน API ทั่วไปได้ที่คู่มือสำหรับนักพัฒนาซอฟต์แวร์
การแสดง JSON |
---|
{ "deviceId": string, "serialNumber": string, "status": string, "lastSync": string, "supportEndDate": string, "annotatedUser": string, "annotatedLocation": string, "notes": string, "model": string, "meid": string, "orderNumber": string, "willAutoRenew": boolean, "osVersion": string, "platformVersion": string, "firmwareVersion": string, "macAddress": string, "bootMode": string, "lastEnrollmentTime": string, "kind": string, "recentUsers": [ { "type": string, "email": string } ], "activeTimeRanges": [ { "activeTime": integer, "date": string } ], "ethernetMacAddress": string, "annotatedAssetId": string, "etag": string, "diskVolumeReports": [ { "volumeInfo": [ { "volumeId": string, "storageTotal": string, "storageFree": string } ] } ], "systemRamTotal": string, "cpuStatusReports": [ { "reportTime": string, "cpuUtilizationPercentageInfo": [ integer ], "cpuTemperatureInfo": [ { "temperature": integer, "label": string } ] } ], "cpuInfo": [ { "model": string, "architecture": string, "maxClockSpeedKhz": integer, "logicalCpus": [ { "maxScalingFrequencyKhz": integer, "currentScalingFrequencyKhz": integer, "idleDuration": string, "cStates": [ { "displayName": string, "sessionDuration": string } ] } ] } ], "deviceFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "systemRamFreeReports": [ { "reportTime": string, "systemRamFreeInfo": [ string ] } ], "lastKnownNetwork": [ { "ipAddress": string, "wanIpAddress": string } ], "autoUpdateExpiration": string, "ethernetMacAddress0": string, "dockMacAddress": string, "manufactureDate": string, "orgUnitPath": string, "tpmVersionInfo": { "family": string, "specLevel": string, "manufacturer": string, "tpmModel": string, "firmwareVersion": string, "vendorSpecific": string }, "screenshotFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "orgUnitId": string, "osUpdateStatus": { object ( |
ช่อง | |
---|---|
deviceId |
รหัสที่ไม่ซ้ำกันของอุปกรณ์ Chrome |
serialNumber |
หมายเลขซีเรียลของอุปกรณ์ Chrome ที่ป้อนเมื่อเปิดใช้งานอุปกรณ์ ค่านี้คือค่าเดียวกับหมายเลขซีเรียลของคอนโซลผู้ดูแลระบบในแท็บอุปกรณ์ ChromeOS |
status |
สถานะของอุปกรณ์ ค่าที่ยอมรับได้มีดังนี้
|
lastSync |
วันที่และเวลาที่ซิงค์อุปกรณ์กับการตั้งค่านโยบายในคอนโซลผู้ดูแลระบบครั้งล่าสุด ค่าจะอยู่ในรูปแบบวันที่และเวลา ISO 8601 เวลาจะเป็นวันที่ที่ครบถ้วนพร้อมกับชั่วโมง นาที และวินาทีในรูปแบบ |
supportEndDate |
วันที่สุดท้ายที่จะรองรับอุปกรณ์ ใช้ได้เฉพาะกับอุปกรณ์ที่ซื้อจาก Google โดยตรงเท่านั้น ค่าจะอยู่ในรูปแบบวันที่และเวลา ISO 8601 เวลาจะเป็นวันที่ที่ครบถ้วนพร้อมกับชั่วโมง นาที และวินาทีในรูปแบบ |
annotatedUser |
ผู้ใช้อุปกรณ์ตามที่ผู้ดูแลระบบระบุไว้ โดยมีความยาวสูงสุดได้ 100 อักขระ มีค่าเว้นว่างได้ |
annotatedLocation |
ที่อยู่หรือตำแหน่งของอุปกรณ์ที่ผู้ดูแลระบบระบุไว้ ความยาวสูงสุดคือ |
notes |
หมายเหตุเกี่ยวกับอุปกรณ์นี้ที่ผู้ดูแลระบบเพิ่ม คุณค้นหาพร็อพเพอร์ตี้นี้ได้ด้วยพารามิเตอร์ |
model |
ข้อมูลรุ่นของอุปกรณ์ หากอุปกรณ์ไม่มีข้อมูลนี้ คุณสมบัตินี้จะไม่รวมอยู่ในคำตอบ |
meid |
Mobile Device Identifier (MEID) หรือ International Mobile Devices Identity (IMEI) สำหรับการ์ดอุปกรณ์เคลื่อนที่ 3G ในอุปกรณ์เคลื่อนที่ โดยทั่วไปแล้วจะใช้ MEID/IMEI เมื่อเพิ่มอุปกรณ์ลงในแผนบริการแบบชำระเงินภายหลังของผู้ให้บริการเครือข่ายมือถือ หากอุปกรณ์ไม่มีข้อมูลนี้ คุณสมบัตินี้จะไม่รวมอยู่ในคำตอบ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีการส่งออกรายการ MEID/IMEI โปรดดูคู่มือนักพัฒนาซอฟต์แวร์ |
orderNumber |
หมายเลขคำสั่งซื้อของอุปกรณ์ เฉพาะอุปกรณ์ที่ซื้อจาก Google โดยตรงเท่านั้นที่มีหมายเลขคำสั่งซื้อ |
willAutoRenew |
กำหนดว่าอุปกรณ์จะต่ออายุการสนับสนุนโดยอัตโนมัติหลังจากวันที่สิ้นสุดการสนับสนุนหรือไม่ พร็อพเพอร์ตี้นี้เป็นพร็อพเพอร์ตี้แบบอ่านอย่างเดียว |
osVersion |
เวอร์ชันระบบปฏิบัติการของอุปกรณ์ Chrome |
platformVersion |
เวอร์ชันแพลตฟอร์มของอุปกรณ์ Chrome |
firmwareVersion |
เวอร์ชันเฟิร์มแวร์ของอุปกรณ์ Chrome |
macAddress |
ที่อยู่ MAC แบบไร้สายของอุปกรณ์ หากอุปกรณ์ไม่มีข้อมูลนี้ ก็จะไม่รวมอยู่ในคำตอบ |
bootMode |
โหมดเปิดเครื่องสำหรับอุปกรณ์ ค่าที่เป็นไปได้มีดังนี้
|
lastEnrollmentTime |
วันที่และเวลาลงทะเบียนอุปกรณ์ครั้งล่าสุด ค่าจะอยู่ในรูปแบบวันที่และเวลา ISO 8601 เวลาจะเป็นวันที่ที่ครบถ้วนพร้อมกับชั่วโมง นาที และวินาทีในรูปแบบ |
kind |
ประเภทของทรัพยากร สำหรับทรัพยากรของอุปกรณ์ ChromeOS ค่าจะเป็น |
recentUsers[] |
รายชื่อผู้ใช้อุปกรณ์ล่าสุดเรียงตามเวลาที่เข้าสู่ระบบครั้งล่าสุดจากมากไปหาน้อย |
recentUsers[].type |
ประเภทของผู้ใช้ ค่าที่ยอมรับได้มีดังนี้
|
recentUsers[].email |
อีเมลของผู้ใช้ ตัวเลือกนี้จะปรากฏก็ต่อเมื่อประเภทผู้ใช้คือ |
activeTimeRanges[] |
รายการช่วงเวลาที่ใช้งานอยู่ (อ่านอย่างเดียว) |
activeTimeRanges[].activeTime |
ระยะเวลาการใช้งานเป็นมิลลิวินาที |
activeTimeRanges[].date |
วันที่ใช้งาน |
ethernetMacAddress |
ที่อยู่ MAC ของอุปกรณ์บนอินเทอร์เฟซเครือข่ายอีเทอร์เน็ต |
annotatedAssetId |
ตัวระบุสินทรัพย์ตามที่ผู้ดูแลระบบระบุไว้หรือระบุไว้ระหว่างการลงทะเบียน |
etag |
ETag ของทรัพยากร |
diskVolumeReports[] |
รายงานพื้นที่ในดิสก์และข้อมูลอื่นๆ เกี่ยวกับวอลุ่มที่ต่อเชื่อม/เชื่อมต่อ |
diskVolumeReports[].volumeInfo[] |
วอลุ่มของดิสก์ |
diskVolumeReports[].volumeInfo[].volumeId |
รหัสเล่ม |
diskVolumeReports[].volumeInfo[].storageTotal |
พื้นที่ในดิสก์ทั้งหมด [เป็นไบต์] |
diskVolumeReports[].volumeInfo[].storageFree |
พื้นที่ว่างในดิสก์ [เป็นไบต์] |
systemRamTotal |
RAM ทั้งหมดในอุปกรณ์ในหน่วยไบต์ |
cpuStatusReports[] |
รายงานการใช้งานและอุณหภูมิของ CPU (อ่านอย่างเดียว) |
cpuStatusReports[].reportTime |
วันที่และเวลาที่ได้รับรายงาน |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
รายการตัวอย่างอุณหภูมิของ CPU |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
อุณหภูมิเป็นเซลเซียสองศา |
cpuStatusReports[].cpuTemperatureInfo[].label |
ป้ายกำกับ CPU |
cpuInfo[] |
ข้อมูลเกี่ยวกับข้อมูลจำเพาะของ CPU ในอุปกรณ์ |
cpuInfo[].model |
ชื่อรุ่น CPU |
cpuInfo[].architecture |
สถาปัตยกรรม CPU |
cpuInfo[].maxClockSpeedKhz |
ความเร็วนาฬิกาของ CPU สูงสุดในหน่วย kHz |
cpuInfo[].logicalCpus[] |
ข้อมูลสำหรับ CPU แบบลอจิคัล |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
ความถี่สูงสุดที่ CPU ทำงานได้ตามนโยบาย |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
ความถี่ปัจจุบันที่ CPU ทำงานอยู่ |
cpuInfo[].logicalCpus[].idleDuration |
เวลาที่ไม่มีการใช้งานตั้งแต่เปิดเครื่องครั้งล่าสุด ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
cpuInfo[].logicalCpus[].cStates[] |
สถานะ C จะระบุสถานะการใช้พลังงานของ CPU หากต้องการข้อมูลเพิ่มเติม โปรดดูเอกสารที่เผยแพร่โดยผู้ผลิต CPU |
cpuInfo[].logicalCpus[].cStates[].displayName |
ชื่อรัฐ |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
เวลาที่ใช้ในการอยู่ในสถานะดังกล่าวนับตั้งแต่การรีบูตครั้งล่าสุด ระยะเวลาเป็นวินาทีที่มีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย " |
deviceFiles[] |
รายการไฟล์อุปกรณ์ที่จะดาวน์โหลด (อ่านอย่างเดียว) |
deviceFiles[].name |
ชื่อไฟล์ |
deviceFiles[].type |
ประเภทไฟล์ |
deviceFiles[].downloadUrl |
URL สำหรับดาวน์โหลดไฟล์ |
deviceFiles[].createTime |
วันที่และเวลาที่สร้างไฟล์ |
systemRamFreeReports[] |
รายงานจำนวนหน่วยความจำ RAM ที่มีอยู่ (อ่านอย่างเดียว) |
systemRamFreeReports[].reportTime |
วันที่และเวลาที่ได้รับรายงาน |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
มีเครือข่ายที่รู้จักล่าสุด (อ่านอย่างเดียว) |
lastKnownNetwork[].ipAddress |
ที่อยู่ IP |
lastKnownNetwork[].wanIpAddress |
ที่อยู่ IP ของ WAN |
autoUpdateExpiration |
(อ่านอย่างเดียว) การประทับเวลาที่อุปกรณ์จะหยุดรับการอัปเดตหรือการสนับสนุนของ Chrome |
ethernetMacAddress0 |
(อ่านอย่างเดียว) ที่อยู่ MAC ที่พอร์ตอีเทอร์เน็ตภายในของ Chromebook ใช้และสำหรับอินเทอร์เฟซเครือข่าย (อีเทอร์เน็ต) ในเครื่อง โดยจะอยู่ในรูปแบบเลขฐานสิบหกสิบสอง (12) หลักที่ไม่มีตัวคั่น การดำเนินการนี้เกี่ยวข้องกับอุปกรณ์บางรุ่นเท่านั้น |
dockMacAddress |
(อ่านอย่างเดียว) ที่อยู่ MAC ในตัวสำหรับ Docking Station ที่อุปกรณ์เชื่อมต่ออยู่ เป็นค่าเริ่มต้นสำหรับการควบคุมการเข้าถึงสื่อ (ที่อยู่ MAC) ที่แท่นชาร์จกำหนดให้ใช้กับแท่นชาร์จ สงวนไว้สำหรับนโยบายด้านอุปกรณ์ผ่าน MAC โดยเฉพาะ โดยจะอยู่ในรูปแบบเลขฐานสิบหกสิบสอง (12) หลักที่ไม่มีตัวคั่น การดำเนินการนี้เกี่ยวข้องกับอุปกรณ์บางรุ่นเท่านั้น |
manufactureDate |
(อ่านอย่างเดียว) วันที่ผลิตอุปกรณ์ในรูปแบบ ปปปป-ดด-วว |
orgUnitPath |
เส้นทางระดับบนสุดแบบเต็มที่มีชื่อหน่วยขององค์กรที่เชื่อมโยงกับอุปกรณ์ ชื่อเส้นทางไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ หากหน่วยขององค์กรระดับบนสุดเป็นองค์กรระดับบนสุด ระบบจะแสดงเป็นเครื่องหมายทับ |
tpmVersionInfo |
โมดูลแพลตฟอร์มที่เชื่อถือได้ (TPM) (อ่านอย่างเดียว) |
tpmVersionInfo.family |
กลุ่ม TPM เราใช้การเข้ารหัสรูปแบบ TPM 2.0 เช่น |
tpmVersionInfo.specLevel |
ระดับข้อกำหนด TPM ดูข้อกำหนดของไลบรารีสำหรับ TPM 2.0 และข้อกำหนดหลักของ TPM 1.2 |
tpmVersionInfo.manufacturer |
รหัสผู้ผลิต TPM |
tpmVersionInfo.tpmModel |
หมายเลขรุ่น TPM |
tpmVersionInfo.firmwareVersion |
เวอร์ชันเฟิร์มแวร์ TPM |
tpmVersionInfo.vendorSpecific |
ข้อมูลเฉพาะผู้ให้บริการ เช่น รหัสผู้ให้บริการ |
screenshotFiles[] |
รายการไฟล์ภาพหน้าจอให้ดาวน์โหลด ประเภทจะเป็น "SCREENSHOT_FILE" เสมอ (อ่านอย่างเดียว) |
screenshotFiles[].name |
ชื่อไฟล์ |
screenshotFiles[].type |
ประเภทไฟล์ |
screenshotFiles[].downloadUrl |
URL สำหรับดาวน์โหลดไฟล์ |
screenshotFiles[].createTime |
วันที่และเวลาที่สร้างไฟล์ |
orgUnitId |
รหัสที่ไม่ซ้ำกันของหน่วยขององค์กร orgUnitPath คือ orgUnitId เวอร์ชันที่มนุษย์อ่านได้ แม้ว่า orgUnitPath อาจเปลี่ยนไปด้วยการเปลี่ยนชื่อหน่วยขององค์กรภายในเส้นทาง แต่ orgUnitId ไม่สามารถเปลี่ยนให้กับหน่วยขององค์กรเดียว คุณอัปเดตพร็อพเพอร์ตี้นี้ได้โดยใช้ API โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างโครงสร้างองค์กรสำหรับอุปกรณ์ที่ศูนย์ช่วยเหลือสำหรับการดูแลระบบ |
osUpdateStatus |
สถานะของการอัปเดตระบบปฏิบัติการของอุปกรณ์ |
firstEnrollmentTime |
วันที่และเวลาที่ลงทะเบียนอุปกรณ์เป็นครั้งแรก |
lastDeprovisionTimestamp |
(อ่านอย่างเดียว) วันที่และเวลาสำหรับการยกเลิกการจัดสรรครั้งล่าสุดของอุปกรณ์ |
deprovisionReason |
(อ่านอย่างเดียว) เหตุผลในการยกเลิกการจัดสรร |
deviceLicenseType |
เอาต์พุตเท่านั้น ประเภทใบอนุญาตของอุปกรณ์ |
backlightInfo[] |
เอาต์พุตเท่านั้น มีข้อมูลไฟแบ็กไลต์ของอุปกรณ์ |
OsUpdateStatus
มีข้อมูลเกี่ยวกับสถานะการอัปเดตระบบปฏิบัติการปัจจุบัน
การแสดง JSON |
---|
{
"state": enum ( |
ช่อง | |
---|---|
state |
สถานะการอัปเดตของการอัปเดตระบบปฏิบัติการ |
targetOsVersion |
กําลังดาวน์โหลดและใช้อิมเมจระบบปฏิบัติการเวอร์ชันใหม่บนแพลตฟอร์ม โดยจะตั้งค่าเมื่อสถานะการอัปเดตเป็น UPDATE_STATUS_DOWNLOAD_IN_PROGRESS หรือ UPDATE_STATUS_NEED_REBOOT เท่านั้น โปรดทราบว่านี่อาจเป็น "0.0.0.0" จำลองสำหรับ UPDATE_STATUS_NEED_REBOOT ในกรณี Edge Case บางกรณี เช่น มีการรีสตาร์ทเครื่องมืออัปเดตโดยไม่มีการรีบูต |
targetKioskAppVersion |
แพลตฟอร์มเวอร์ชันใหม่ที่จำเป็นจากแอปคีออสก์ที่อัปเดตที่รอดำเนินการ |
updateTime |
วันที่และเวลาที่การอัปเดตระบบปฏิบัติการสำเร็จครั้งล่าสุด |
updateCheckTime |
วันที่และเวลาของการตรวจสอบการอัปเดตครั้งล่าสุด |
rebootTime |
วันที่และเวลาที่รีบูตครั้งล่าสุด |
UpdateState
สถานะการอัปเดตของการอัปเดตระบบปฏิบัติการ
Enum | |
---|---|
UPDATE_STATE_UNSPECIFIED |
ไม่ได้ระบุสถานะการอัปเดต |
UPDATE_STATE_NOT_STARTED |
มีอัปเดตรอดำเนินการอยู่ แต่ยังไม่เริ่มต้น |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
กำลังดาวน์โหลดอัปเดตที่รอดำเนินการ |
UPDATE_STATE_NEED_REBOOT |
อุปกรณ์พร้อมติดตั้งการอัปเดตแล้ว แต่ต้องรีบูต |
DeprovisionReason
สาเหตุของการยกเลิกการจัดสรรอุปกรณ์ ChromeOS
Enum | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
ไม่ทราบเหตุผลที่ยกเลิกการจัดสรร |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
การเปลี่ยนแทนด้วยรุ่นเดียวกัน คุณได้รับอนุญาตให้ส่งคืนอุปกรณ์ (RMA) หรือคุณกำลังจะเปลี่ยนอุปกรณ์ที่ชำรุดซึ่งอยู่ภายใต้การรับประกันเป็นอุปกรณ์รุ่นเดียวกัน |
DEPROVISION_REASON_UPGRADE |
อัปเกรดอุปกรณ์แล้ว |
DEPROVISION_REASON_DOMAIN_MOVE |
มีการเปลี่ยนแปลงโดเมนของอุปกรณ์ |
DEPROVISION_REASON_SERVICE_EXPIRATION |
บริการหมดอายุสำหรับอุปกรณ์ |
DEPROVISION_REASON_OTHER |
ยกเลิกการจัดสรรอุปกรณ์ด้วยเหตุผลเดิมที่ไม่รองรับแล้ว |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
การเปลี่ยนแทนด้วยรุ่นที่ต่างกัน คุณกำลังจะเปลี่ยนอุปกรณ์นี้เป็นรุ่นที่อัปเกรดแล้วหรือรุ่นที่ใหม่กว่า |
DEPROVISION_REASON_RETIRING_DEVICE |
เลิกใช้งานในองค์กร คุณกำลังบริจาค ทิ้ง หรือนำอุปกรณ์ออกจากการใช้งาน |
DEPROVISION_REASON_UPGRADE_TRANSFER |
การโอนการอัปเกรด ChromeOS Flex อุปกรณ์นี้เป็นอุปกรณ์ ChromeOS Flex ที่คุณจะเปลี่ยนเป็น Chromebook ภายใน 1 ปี |
DEPROVISION_REASON_NOT_REQUIRED |
โดยไม่จำเป็นต้องระบุเหตุผล เช่น ใบอนุญาตถูกส่งไปยังกลุ่มใบอนุญาตของลูกค้า |
DEPROVISION_REASON_REPAIR_CENTER |
ศูนย์บริการซ่อมยกเลิกการจัดสรรอุปกรณ์แล้ว ตั้งค่าได้โดยศูนย์บริการซ่อมในช่วง RMA เท่านั้น |
DeviceLicenseType
ประเภทใบอนุญาตของอุปกรณ์นี้
Enum | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
ไม่รู้จักประเภทใบอนุญาต |
ENTERPRISE |
อุปกรณ์มาพร้อมกับ Chrome Enterprise Upgrade แบบตลอดชีพ |
ENTERPRISE_UPGRADE |
อุปกรณ์มี Chrome Enterprise Upgrade แบบสแตนด์อโลนรายปี |
EDUCATION_UPGRADE |
อุปกรณ์มี Chrome Education Upgrade แบบสแตนด์อโลนแบบถาวร |
EDUCATION |
อุปกรณ์มาพร้อมกับ Chrome Education Upgrade แบบตลอดชีพ |
KIOSK_UPGRADE |
อุปกรณ์มี Kiosk Upgrade รายปี |
BacklightInfo
ข้อมูลเกี่ยวกับแบ็กไลต์ของอุปกรณ์
การแสดง JSON |
---|
{ "path": string, "maxBrightness": integer, "brightness": integer } |
ช่อง | |
---|---|
path |
เอาต์พุตเท่านั้น เส้นทางไปยัง Backlight นี้ในระบบ มีประโยชน์ในกรณีที่ผู้โทรจำเป็นต้องเชื่อมโยงกับข้อมูลอื่นๆ |
maxBrightness |
เอาต์พุตเท่านั้น ความสว่างสูงสุดสำหรับไฟแบ็กไลต์ |
brightness |
เอาต์พุตเท่านั้น ความสว่างปัจจุบันของ Backlight จะอยู่ระหว่าง 0 ถึง maxBrightness |
วิธีการ |
|
---|---|
(deprecated) |
ใช้ BatchChangeChromeOsDeviceStatus แทน |
|
เรียกพร็อพเพอร์ตี้ของอุปกรณ์ Chrome OS |
|
เรียกข้อมูลรายการอุปกรณ์ Chrome OS ที่ใส่เลขหน้าภายในบัญชี |
|
ย้ายหรือแทรกอุปกรณ์ Chrome OS หลายเครื่องไปยังหน่วยขององค์กร |
|
อัปเดตพร็อพเพอร์ตี้ที่อัปเดตได้ของอุปกรณ์ เช่น annotatedUser , annotatedLocation , notes , orgUnitPath หรือ annotatedAssetId |
|
อัปเดตพร็อพเพอร์ตี้ที่อัปเดตได้ของอุปกรณ์ เช่น annotatedUser , annotatedLocation , notes , orgUnitPath หรือ annotatedAssetId |