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

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 พารามิเตอร์ ระบบได้ หากไม่ระบุพารามิเตอร์ 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 ที่ระบุได้ไว้ในการตอบกลับ หากระบุ 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: รหัสข้อมูลสินค้าที่แสดงสำหรับแอปนี้

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