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

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

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

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

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

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

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

เมธอด 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 ไดรฟ์

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

คุณสามารถตั้งค่าพารามิเตอร์ 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: รหัสข้อมูลผลิตภัณฑ์สำหรับแอปนี้

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