ชิ้นงาน: การค้นหา

ค้นหาชิ้นงาน Looker Studio ของผู้ใช้

ส่งคำขอ

คำขอ HTTP

GET https://datastudio.googleapis.com/v1/assets:search

พารามิเตอร์

ชื่อพารามิเตอร์ ประเภท คำอธิบาย
assetTypes Array<AssetType> ต้องระบุ ประเภทเนื้อหาที่จะค้นหา ต้องระบุประเภทชิ้นงาน 1 ประเภทเท่านั้น
title สตริง สตริงการค้นหา โดยค่าเริ่มต้น ระบบจะตรวจสอบสตริงกับชื่อและคำอธิบายของเนื้อหา ดูสตริงการค้นหาขั้นสูงได้ที่ส่วนตัวอย่าง
includeTrashed บูลีน ค่าเริ่มต้นคือ false
  • เมื่อตั้งค่าพารามิเตอร์นี้เป็น true ระบบจะรวมเฉพาะชิ้นงานจากถังขยะ
  • เมื่อตั้งค่าพารามิเตอร์นี้เป็น false ระบบจะรวมเฉพาะชิ้นงานที่ไม่ได้อยู่ในถังขยะ
เจ้าของ สตริง อีเมลของเจ้าของเนื้อหา
orderBy สตริง ลำดับของผลลัพธ์ คุณจัดเรียงตามช่องต่อไปนี้ได้
  • title
  • last_viewed_by_me
  • create_time
  • last_accessed_time
  • id
pageSize ตัวเลข จำนวนผลลัพธ์ที่จะรวมต่อหน้า ค่าเริ่มต้นคือ 1,000
pageToken สตริง โทเค็นที่ระบุหน้าผลการค้นหาที่จะแสดง หากต้องการแบ่งหน้าผลลัพธ์ ให้ใช้ค่า nextPageToken หรือค่า previousPageToken จากคำขออื่น

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

ขอบเขต
https://www.googleapis.com/auth/datastudio.readonly
https://www.googleapis.com/auth/datastudio

เนื้อความของคำขอ

อย่าระบุเนื้อหาคำขอด้วยเมธอดนี้

การตอบกลับ

หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับที่มีโครงสร้างดังนี้

{
  "assets": [Asset],
  "nextPageToken": string
}
ชื่อพร็อพเพอร์ตี้ ประเภท คำอธิบาย
เนื้อหา Array<Asset> รายการเนื้อหา
nextPageToken สตริง โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไป พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อจำนวนผลลัพธ์มากกว่าคำขอ pageSize nextPageToken ที่ว่างเปล่าแสดงว่าไม่มีผลลัพธ์ที่จะแสดงอีกต่อไป
previousPageToken สตริง โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าก่อนหน้า previousPageToken ที่ว่างเปล่าแสดงถึงจุดเริ่มต้นของชุดผลลัพธ์

ตัวอย่าง

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

ตัวกรอง คำจำกัดความ ตัวอย่าง
ผู้สร้าง ค้นหาชิ้นงานที่สร้างโดยผู้ใช้ที่ระบุ
  • creator:me
  • creator:user@example.com
เจ้าของ ค้นหาเนื้อหาที่เป็นของผู้ใช้ที่เฉพาะเจาะจง
  • owner:me
  • owner:user@example.com
โปรเจ็กต์ ค้นหาชิ้นงานในโปรเจ็กต์
  • projectNumber:123456789
Workspace ค้นหาชิ้นงานในพื้นที่ทำงานหรือโฟลเดอร์
  • parentWorkspace:2a080c66-50cb-4399-92a8-74c534da2de9
จาก ค้นหาชิ้นงานที่ผู้ใช้แชร์กับคุณ
  • from:user@example.com
ถึง ค้นหาชิ้นงานที่คุณแชร์กับผู้ใช้หรือกลุ่ม
  • to:user@example.com
  • to:example-group@googlegroups.com