ส่งคืนข้อมูลผู้ใช้

Google ไดรฟ์มอบ 2 ตัวเลือกในการรวบรวมข้อมูลเกี่ยวกับผู้ใช้ไดรฟ์ ได้แก่

  • เมื่อใช้ทรัพยากร about คุณจะเรียกดูข้อมูลเกี่ยวกับผู้ใช้ การตั้งค่าไดรฟ์ของผู้ใช้ และความสามารถของระบบได้

  • ใช้ทรัพยากร apps เพื่อเรียกดูรายการแอปที่ติดตั้งของผู้ใช้ พร้อมข้อมูลเกี่ยวกับประเภท MIME ที่แต่ละแอปรองรับ รวมถึงนามสกุลไฟล์และรายละเอียดอื่นๆ

คู่มือนี้จะอธิบายวิธีเรียกข้อมูลผู้ใช้ในไดรฟ์

ดึงข้อมูลเกี่ยวกับผู้ใช้

หากต้องการแสดงผลข้อมูลของผู้ใช้ไดรฟ์เป็นอินสแตนซ์ของ about ให้ใช้เมธอด about.get เมธอด about.get ต้องใช้พารามิเตอร์การค้นหา fields ในการเรียกเมธอด ค่าที่ส่งกลับจะวัดเป็นไบต์ ดูข้อมูลเพิ่มเติมได้ที่ส่งคืนช่องที่เจาะจงสำหรับไฟล์

แสดงตัวอย่าง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุ fields หลายรายการเป็นพารามิเตอร์การค้นหาในคําขอ การตอบกลับจะแสดงค่าในช่องสำหรับคำขอ

คำขอ

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

การตอบกลับ

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

คำตอบจะมีค่าต่อไปนี้

  • DISPLAY_NAME: ชื่อผู้ใช้ในข้อความธรรมดา
  • PHOTO_LINK: URL ของรูปโปรไฟล์ของผู้ใช้
  • PERMISSION_ID: รหัสผู้ใช้ภายในทรัพยากร Permission
  • EMAIL_ADDRESS: อีเมลของผู้ใช้

ดึงข้อมูลเกี่ยวกับแอปของผู้ใช้

แอปของ Google ไดรฟ์จะอยู่ใน Google Workspace Marketplace และมีไว้เพื่อเพิ่มความสะดวกให้กับไดรฟ์ เช่น แอป Google เอกสารหรือส่วนเสริมที่ใช้ภายใน Google เอกสารเพื่อเซ็นเอกสาร โปรดดูข้อมูลเพิ่มเติมที่ใช้แอปของ Google ไดรฟ์

หากต้องการแสดงรายการแอปทั้งหมดที่ผู้ใช้ติดตั้งไว้เป็นอินสแตนซ์ของ apps ให้ใช้เมธอด apps.list โดยไม่มีพารามิเตอร์ใดๆ

แสดงตัวอย่าง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีส่งกลับรายการแอปที่ผู้ใช้ติดตั้งทั้งหมดในคำขอ การตอบกลับจะแสดงค่าในช่องสำหรับคำขอ

คำขอ

GET https://www.googleapis.com/drive/v3/apps

การตอบกลับ

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

คำตอบจะมีค่าต่อไปนี้

  • ID: รหัสแอป
  • PRODUCT_ID: รหัสข้อมูลผลิตภัณฑ์ที่แสดงสำหรับแอปนี้

แสดงรายการแอปของผู้ใช้ด้วยพารามิเตอร์การค้นหา

หากต้องการค้นหาแอปที่เจาะจง ให้ใช้พารามิเตอร์การค้นหาที่ไม่บังคับอย่างน้อย 1 รายการ

  • appFilterExtensions: กรองผลการค้นหาโดยใช้รายการนามสกุลไฟล์ที่คั่นด้วยเครื่องหมายจุลภาค แอปภายในขอบเขตการค้นหาแอปที่เปิดนามสกุลไฟล์ที่ระบุได้จะรวมอยู่ในการตอบกลับ หากระบุ appFilterMimeTypes ด้วย ระบบจะแสดงผลรายการแอปที่ได้ทั้งหมด 2 รายการกลับมา ตัวอย่างของส่วนขยาย ได้แก่ docx สำหรับ Microsoft Word และ pptx สำหรับ Microsoft PowerPoint ดูตัวอย่างเพิ่มเติมของนามสกุลไฟล์ได้ที่หัวข้อส่งออกประเภท MIME สำหรับเอกสาร Google Workspace

    ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใส่นามสกุลไฟล์หลายรายการเป็นพารามิเตอร์การค้นหา: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx

  • appFilterMimeTypes: กรองผลการค้นหาโดยใช้รายการประเภท MIME ที่คั่นด้วยคอมมา แอปภายในขอบเขตการค้นหาแอปที่เปิดประเภท MIME ที่ระบุจะรวมอยู่ในคำตอบด้วย หากมีการระบุ appFilterExtensions ด้วย ระบบจะแสดงผลรายการแอปที่ได้ 2 รายการกลับมา ตัวอย่างประเภท MIME ได้แก่ application/vnd.google-apps.form สำหรับ Google ฟอร์ม และ application/vnd.google-apps.site สำหรับ Google Sites ดูตัวอย่างประเภท MIME เพิ่มเติมได้ที่ประเภท MIME ที่รองรับ Google Workspace และ Google ไดรฟ์

    ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุ MIME หลายประเภทเป็นพารามิเตอร์การค้นหา: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site

  • languageCode: กรองผลการค้นหาโดยใช้รหัสภาษาหรือสถานที่ตามที่กำหนดโดย BCP 47 โดยมีส่วนขยายบางส่วนจากรูปแบบ LDML ของ Unicode ตัวอย่างรหัสภาษา ได้แก่ en-us สำหรับภาษาอังกฤษ (สหรัฐอเมริกา) และ fr-ca สำหรับฝรั่งเศส (แคนาดา)

    ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุรหัสภาษาหลายภาษาเป็นพารามิเตอร์การค้นหา: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca

ดาวน์โหลดแอปของผู้ใช้ตามรหัส

หากต้องการดาวน์โหลดข้อมูลแอปโดยละเอียดเป็นอินสแตนซ์ของ apps ให้ใช้เมธอด apps.get กับรหัสแอป

แสดงตัวอย่าง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุ appId เป็นพารามิเตอร์การค้นหาในคําขอ การตอบกลับจะแสดงค่าในช่องสำหรับคำขอ

คำขอ

GET https://www.googleapis.com/drive/v3/apps/APP_ID

การตอบกลับ

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

คำตอบจะมีค่าต่อไปนี้

  • ID: รหัสแอป
  • PRODUCT_ID: รหัสข้อมูลผลิตภัณฑ์ที่แสดงสำหรับแอปนี้

ลองทำตามขั้นตอนต่อไปนี้