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: รหัสของผู้ใช้ภายในทรัพยากรPermissionEMAIL_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,pptxappFilterMimeTypes: กรองผลการค้นหาโดยใช้รายการประเภท 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.sitelanguageCode: กรองผลการค้นหาโดยใช้รหัสภาษาหรือรหัสภาษาและประเทศ ตามที่กำหนดโดย 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: รหัสข้อมูลผลิตภัณฑ์สำหรับแอปนี้
หัวข้อที่เกี่ยวข้อง
ขั้นตอนถัดไปที่คุณอาจลองทำมีดังนี้
หากต้องการสร้างไฟล์ในไดรฟ์ โปรดดูสร้างและจัดการไฟล์
หากต้องการอัปโหลดข้อมูลไฟล์เมื่อสร้างหรืออัปเดตไฟล์ โปรดดูอัปโหลดข้อมูลไฟล์
หากต้องการดาวน์โหลดและส่งออกไฟล์ โปรดดูดาวน์โหลดและส่งออก ไฟล์