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

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

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

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

คำแนะนำนี้อธิบายวิธีดึงข้อมูลผู้ใช้ในไดรฟ์

ดูรายละเอียดเกี่ยวกับผู้ใช้

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีระบุ 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 ไดรฟ์

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

หากต้องการระบุช่องที่จะแสดงผลในคำตอบ คุณสามารถตั้งค่า fields system parameter ได้ หากไม่ได้ระบุพารามิเตอร์ fields เซิร์ฟเวอร์จะแสดงชุดฟิลด์เริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่แสดงผลฟิลด์ที่เฉพาะเจาะจง

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

คำขอ

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 types ที่ระบุได้จะรวมอยู่ในการตอบกลับ หากระบุ 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 ให้ใช้เมธอด 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: รหัสข้อมูลผลิตภัณฑ์สำหรับแอปนี้

ขั้นตอนถัดไปที่คุณอาจลองทำมีดังนี้