กําหนดค่าการผสานรวม UI ของไดรฟ์

หากต้องการแสดงแอปใน Google ไดรฟ์เมื่อผู้ใช้สร้างหรือเปิดไฟล์ คุณต้องตั้งค่าการผสานรวมอินเทอร์เฟซผู้ใช้ (UI) ของไดรฟ์ก่อน นอกจากนี้ คุณยังต้องกำหนดค่าเพื่อแสดงแอปใน Google Workspace Marketplace ด้วย

เปิดใช้ Drive API

ก่อนใช้ Google API คุณต้องเปิด API เหล่านั้นในโปรเจ็กต์ Google Cloud โดยสามารถเปิด API อย่างน้อย 1 รายการในโปรเจ็กต์ Google Cloud เดียวได้

หากต้องการเริ่มต้นผสานรวมกับ UI ของ Google ไดรฟ์ คุณต้องเปิดใช้ Drive API ซึ่งจะช่วยให้คุณเข้าถึง API และฟีเจอร์การผสานรวม UI ได้

• เปิดใช้ Google Drive API ในคอนโซล Google Cloud

  เปิดใช้ API

ตั้งค่าการผสานรวม UI ของไดรฟ์

1. ในคอนโซล Google API ให้ไปที่เมนู menu > API และบริการ > API และบริการที่เปิดใช้

   ไปที่ API และบริการที่เปิดใช้

2. คลิก Google Drive API ที่ด้านล่างของแดชบอร์ด API และบริการ หน้าการกำหนดค่า Google Drive API จะปรากฏขึ้น
3. เลือกแท็บการผสานรวม UI ของไดรฟ์
4. (ไม่บังคับ) ป้อนชื่อในช่องชื่อแอปพลิเคชัน ชื่อแอปพลิเคชันจะแสดงต่อผู้ใช้ในแท็บจัดการแอปในการตั้งค่าไดรฟ์
5. (ไม่บังคับ) ป้อนคำอธิบายสั้นๆ 1 บรรทัดในช่องคำอธิบายสั้นๆ คำอธิบายสั้นๆ จะแสดงต่อผู้ใช้ในแท็บจัดการแอปในการตั้งค่าไดรฟ์
6. (ไม่บังคับ) ป้อนคำอธิบายแบบเต็มในช่องคำอธิบายแบบยาว

7. อัปโหลดไอคอนแอปพลิเคชัน อย่างน้อย 1 รายการเพื่อแสดงในรายการแอปไดรฟ์ที่เชื่อมต่อของผู้ใช้และในเมนูตามบริบท "เปิดด้วย" ไอคอนควรอยู่ในรูปแบบ PNG ที่มีพื้นหลังโปร่งใส ไอคอนอาจใช้เวลาสูงสุด 24 ชั่วโมงจึงจะปรากฏในไดรฟ์

8. หากต้องการใช้รายการเมนู "เปิดด้วย" ของ UI ไดรฟ์ รายการ ให้ป้อน URL ของแอปในช่อง เปิด URL เมนูตามบริบท "เปิดด้วย" จะใช้ URL นี้

   • URL นี้ต้องมีชื่อโดเมนที่สมบูรณ์ในตัวเอง localhost ใช้ไม่ได้
   • URL นี้ควรเข้าถึงได้สำหรับผู้ใช้แอปพลิเคชันที่ต้องการ หากคุณมีแอปพลิเคชันหลายเวอร์ชัน เช่น เวอร์ชันสำหรับการเผยแพร่ต่อสาธารณะและเวอร์ชันสำหรับการเผยแพร่แบบจำกัดให้ผู้ใช้บางราย แต่ละเวอร์ชันควรใช้ URL ที่ไม่ซ้ำกัน จากนั้นคุณจะสร้างการกำหนดค่าแอปที่แตกต่างกันสำหรับแต่ละเวอร์ชันได้
   • คุณต้อง ยืนยันการเป็นเจ้าของ URL นี้ ก่อนจึงจะแสดงแอปใน Google Workspace Marketplace ได้
   • โดยค่าเริ่มต้น ระบบจะเพิ่มพารามิเตอร์การค้นหา state ลงใน URL นี้เพื่อส่ง ข้อมูลจาก UI ของไดรฟ์ไปยังแอปของคุณ ดูข้อมูลเกี่ยวกับ เนื้อหาของพารามิเตอร์ state ได้ที่ พารามิเตอร์ state

9. (ไม่บังคับ) ป้อนประเภท MIME และนามสกุลไฟล์เริ่มต้นในช่องประเภท MIME เริ่มต้น และนามสกุลไฟล์เริ่มต้น ประเภท MIME และนามสกุลไฟล์เริ่มต้นแสดงถึงไฟล์ที่แอปของคุณสร้างขึ้นมาเพื่อเปิดโดยเฉพาะ เช่น แอปของคุณอาจเปิดรูปแบบในตัวสำหรับการซ้อนเลเยอร์และแก้ไขรูปภาพ โปรดระบุเฉพาะประเภทสื่อ มาตรฐาน และตรวจสอบว่าไม่มีการสะกดผิด หากแอปของคุณเปิดได้เฉพาะไฟล์ทางลัดหรือไฟล์ทางลัดของบุคคลที่สาม คุณสามารถเว้นช่องประเภท MIME ว่างไว้ได้

10. (ไม่บังคับ) ป้อนประเภท MIME และนามสกุลไฟล์รองในช่องประเภท MIME รอง และนามสกุลไฟล์รอง ประเภท MIME และนามสกุลไฟล์รองแสดงถึงไฟล์ที่แอปของคุณเปิดได้ แต่ไม่ได้เจาะจงสำหรับแอปของคุณ เช่น แอปของคุณอาจเป็นแอปแต่งภาพที่เปิดรูปภาพ PNG และ JPG ได้ โปรดระบุเฉพาะประเภทสื่อ มาตรฐาน และตรวจสอบว่าไม่มีการสะกดผิด หากแอปของคุณเปิดได้เฉพาะไฟล์ทางลัดหรือไฟล์ทางลัดของบุคคลที่สาม คุณสามารถเว้นช่องประเภท MIME ว่างไว้ได้

11. หากต้องการใช้ปุ่ม "ใหม่" ของ UI ไดรฟ์และให้ผู้ใช้สร้างไฟล์ด้วย แอปของคุณ ให้เลือกช่องการสร้างไฟล์ ช่องURL ใหม่ และช่องชื่อเอกสาร (ไม่บังคับ) จะปรากฏขึ้น

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

12. ป้อน URL ในช่องURL ใหม่ ปุ่ม "ใหม่" จะใช้ URL นี้เพื่อเปลี่ยนเส้นทางผู้ใช้ไปยังแอปพลิเคชันของคุณ

13. (ไม่บังคับ) หากต้องการให้แอปเปิดไฟล์ที่ Google Workspace รองรับ ให้เลือกช่องการนำเข้า

14. (ไม่บังคับ) หากแอปของคุณต้องจัดการไฟล์ในไดรฟ์ที่แชร์ ให้เลือกช่องการรองรับไดรฟ์ที่แชร์ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีรองรับ ไดรฟ์ที่แชร์ในแอปได้ที่หัวข้อการรองรับไดรฟ์ที่แชร์

15. คลิกส่ง

ขอขอบเขต drive.install

หากต้องการอนุญาตให้แอปปรากฏเป็นตัวเลือกในเมนู "เปิดด้วย" หรือ "ใหม่" ให้ขอขอบเขต https://www.googleapis.com/auth/drive.install เพื่อผสานรวมกับ UI ของไดรฟ์ เมื่อขอขอบเขตนี้ ผู้ใช้จะเห็นกล่องโต้ตอบที่คล้ายกับกล่องโต้ตอบต่อไปนี้

ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตที่คุณขอสำหรับแอปไดรฟ์ได้ที่หัวข้อข้อมูลการให้สิทธิ์และการตรวจสอบสิทธิ์เฉพาะสำหรับ API ข้อมูล

พารามิเตอร์ state

โดยค่าเริ่มต้น ระบบจะเพิ่มพารามิเตอร์ state ลงในทั้ง URL สำหรับเปิดไฟล์และ URL ใหม่เพื่อส่งข้อมูลจาก UI ของไดรฟ์ไปยังแอปของคุณ พารามิเตอร์นี้มีสตริงที่เข้ารหัส JSON พร้อมตัวแปรเทมเพลตและข้อมูลเกี่ยวกับคำขอที่ส่งไปยังแอปของคุณ ตัวแปรที่รวมไว้จะขึ้นอยู่กับประเภท URL ที่ใช้ (URL สำหรับเปิดไฟล์หรือ URL ใหม่)

พารามิเตอร์ state มีการเข้ารหัส URL ดังนั้นแอปของคุณต้องจัดการอักขระหลีกและแยกวิเคราะห์เป็น JSON แอปสามารถตรวจหาค่า create ในพารามิเตอร์ state เพื่อยืนยันคำขอสร้างไฟล์

ตัวอย่างข้อมูลสถานะใน JSON สำหรับ URL ใหม่

ข้อมูล state สำหรับ URL ใหม่มีลักษณะดังนี้

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

ตัวอย่างข้อมูลสถานะใน JSON สำหรับ URL สำหรับเปิดไฟล์

ข้อมูล state สำหรับ URL สำหรับเปิดไฟล์มีลักษณะดังนี้

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

ระบบจะใช้รหัสและคีย์ทรัพยากรเพื่อดึงข้อมูลเมตาของไฟล์และดาวน์โหลดเนื้อหาไฟล์ เมื่อแอปของคุณมีรหัสไฟล์และโทเค็นเพื่อการเข้าถึงแล้ว แอปจะตรวจสอบ สิทธิ์ ดึงข้อมูลเมตาของไฟล์ และดาวน์โหลดเนื้อหาไฟล์ได้ตามที่อธิบายไว้ ในเมธอด files.get

หัวข้อที่เกี่ยวข้อง

แอปที่ติดตั้งต้องสร้าง จัดการ และเปิดการดำเนินการที่เปิดตัวจาก UI ของไดรฟ์ได้ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อผสานรวมกับ ปุ่ม "ใหม่" ของ UI ไดรฟ์ หรือ ผสานรวมกับเมนูตามบริบท "เปิดด้วย" ของ UI ไดรฟ์