ใช้ Google Connected Console เพื่อผสานรวม AppFunctions ในอุปกรณ์ของแอป Android กับ Gemini บน Android การสร้างแอปที่เชื่อมต่อด้วยประเภทการเชื่อมต่อ Android MCP และลิงก์กับแอป Play จะช่วยให้ Gemini บน Android สามารถทริกเกอร์การดำเนินการและทำงานให้เสร็จในแอปของคุณโดยตรงในนามของผู้ใช้
คู่มือนี้จะแนะนำเวิร์กโฟลว์แบบบริการตนเองตั้งแต่ต้นจนจบใน Google Connected Console ซึ่งรวมถึงการสร้างแอปที่เชื่อมต่อ, การลิงก์แอป Play, การกำหนดค่าการ์ดแอปสาธารณะ, การอัปโหลดและการส่ง App Bundle, การทดสอบเวอร์ชันตัวอย่างในอุปกรณ์ และการเผยแพร่เวอร์ชันที่ใช้งานจริง
สิ่งที่ต้องมีก่อน
ก่อนเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้
- สิทธิ์เข้าถึงเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์ของแพลตฟอร์มแอปที่เชื่อมต่อ: คุณต้องมีสิทธิ์เข้าถึงเวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์เพื่อสร้างแอปที่เชื่อมต่อและทดสอบกับ Gemini หากต้องการขอสิทธิ์เข้าถึง ให้สมัครเข้าร่วมเวอร์ชันตัวอย่าง
- สิทธิ์เข้าถึงบัญชีนักพัฒนาแอปที่ลงทะเบียนใน Google Connected Console
- การยอมรับข้อกำหนดในการให้บริการ: ครั้งแรกที่องค์กรของคุณเข้าถึงแอปที่เชื่อมต่อใน Google Connected Console เจ้าของบัญชีหรือผู้ดูแลระบบต้องตรวจสอบและยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อก่อนที่สมาชิกในทีมจะสร้างแอปที่เชื่อมต่อได้
- สิทธิ์ของผู้ใช้: หากคุณได้รับเชิญให้เข้าร่วมบัญชีนักพัฒนาแอป Connected Console ที่มีอยู่ แต่ไม่สามารถสร้างแอปที่เชื่อมต่อได้ โปรดขอให้เจ้าของบัญชีหรือผู้ดูแลระบบให้สิทธิ์ดูแอปที่เชื่อมต่อหรือสร้างและจัดการแอปที่เชื่อมต่อแก่คุณในหน้าผู้ใช้และสิทธิ์ นอกจากนี้ คุณยังต้องมีสิทธิ์การจัดการรุ่นสำหรับแอป Play ที่เกี่ยวข้องเพื่ออัปโหลด App Bundle และจัดการรุ่นด้วย
- แอป Play ที่มีอยู่ในบัญชี Google Connected Console
- แอป Play ของคุณต้องอยู่ในบัญชีนักพัฒนาแอปเดียวกันอยู่แล้ว คุณจึงจะลิงก์แอปดังกล่าวกับแอปที่เชื่อมต่อได้ แอป Play แต่ละแอปจะลิงก์กับแอปที่เชื่อมต่อ MCP ของ Android ได้เพียงแอปเดียวเท่านั้น
- ตรวจสอบว่าแอป Play มีข้อมูลสินค้าใน Store เริ่มต้นที่กำหนดค่าด้วยไอคอนแอปและภาษาที่รองรับ ภาษาในข้อมูลสินค้าใน Store ของแอป Play และการกำหนดเป้าหมายประเทศจะเป็นตัวกำหนดประเทศที่แอปที่เชื่อมต่อ Android MCP ของคุณพร้อมให้บริการ
- Android App Bundle (
.aab) ที่ใช้ AppFunctions- กำหนดค่า App Bundle ให้กำหนดเป้าหมายเป็นอุปกรณ์เคลื่อนที่ Android ซึ่งเป็นแพลตฟอร์มที่รองรับการผสานรวมแอป Gemini ในอุปกรณ์
- หมวดหมู่แอปที่เชื่อมต่อและข้อมูลเมตาที่แสดงต่อสาธารณะ: เตรียมชิ้นงานและรายละเอียดที่ประกอบกันเป็นข้อมูลสาธารณะของแอปที่เชื่อมต่อ ดังนี้
- หมวดหมู่แอปที่เชื่อมต่อ: โดเมนหรือหมวดหมู่อุตสาหกรรมสำหรับแอปที่เชื่อมต่อ แต่ละหมวดหมู่จะกำหนดข้อกำหนดด้านความสามารถพื้นฐานและไม่สามารถเปลี่ยนแปลงได้หลังจากสร้างแล้ว
- ชื่อแอป: ชื่อที่แสดงของแอปที่เชื่อมต่อซึ่งแสดงต่อผู้ใช้ในผลิตภัณฑ์ต่างๆ ของ Google และใช้เมื่อผู้ใช้พูดถึงแอปของคุณด้วย
@ใน Gemini - ไอคอนแอปที่เชื่อมต่อ: ไอคอนแอปขนาด 512 x 512 พิกเซลในรูปแบบ JPEG หรือ PNG โดยมีขนาดไฟล์สูงสุด 1 MB (1,024 KB)
- คำอธิบายแอป: สรุปสั้นๆ ที่อธิบายสิ่งที่แอปที่เชื่อมต่อสามารถทำให้ผู้ใช้ได้
- ความสามารถของแอป: ความสามารถที่กำหนดเองอย่างน้อย 3 รายการที่แสดงให้ผู้ใช้เห็นว่าแอปของคุณทำอะไรได้บ้างเมื่อตัดสินใจว่าจะเชื่อมต่อหรือไม่ นอกเหนือจากความสามารถเริ่มต้นที่กำหนดโดยหมวดหมู่ของแอป
- พรอมต์ตัวอย่าง: พรอมต์ตัวอย่างอย่างน้อย 3 รายการที่สอนผู้ใช้ถึงวิธีเรียกใช้แอปของคุณใน Gemini และช่วยให้ผู้ใช้เข้าใจว่าสามารถถามอะไรได้บ้าง
- URL ของนโยบาย: URL ที่เข้าถึงได้แบบสาธารณะสำหรับนโยบายความเป็นส่วนตัว
- URL ของข้อกำหนดในการให้บริการ: URL ที่เข้าถึงได้แบบสาธารณะสำหรับข้อกำหนดในการให้บริการ
- URL ของเว็บไซต์ (ไม่บังคับ): URL ที่เข้าถึงได้แบบสาธารณะซึ่งชี้ไปยังเว็บไซต์ของคุณเพื่อระบุแหล่งที่มา
ลงทะเบียน ทดสอบ และเผยแพร่ AppFunctions ด้วย Gemini
เมื่อมีคุณสมบัติตรงตามข้อกำหนดเบื้องต้นแล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อลงทะเบียนแอปที่เชื่อมต่อ Android MCP, ลิงก์แอป Google Play, กรอกรายละเอียดแอป, อัปโหลดและส่ง AppFunctions, ทดสอบในอุปกรณ์ และเผยแพร่เป็นเวอร์ชันที่ใช้งานจริง
ขั้นตอนที่ 1: สร้างแอปที่เชื่อมต่อ Android MCP และลิงก์กับแอป Play
หากต้องการสร้างแอปที่เชื่อมต่อและลิงก์กับแอป Play ให้ทำตามขั้นตอนต่อไปนี้
- ลงชื่อเข้าใช้ Google Connected Console
- ในหน้าแรก ให้เลือกสร้างแอป
- ในกล่องโต้ตอบเลือกสิ่งที่ต้องการสร้าง ให้ทำดังนี้
- หากได้รับข้อความแจ้งให้ยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อ ให้เลือกดูข้อกำหนด อ่านและยอมรับข้อตกลง แล้วเลือกสร้าง มีเพียงผู้ดูแลระบบบัญชีเท่านั้นที่ยอมรับข้อตกลงได้
- หรือเลือกสร้างในการ์ดแอปที่เชื่อมต่อ
- ในกล่องโต้ตอบตั้งชื่อแอปที่เชื่อมต่อ ให้พิมพ์ชื่อแอปที่เชื่อมต่อ ซึ่งเป็นชื่อที่แสดงแอปที่เชื่อมต่อในผลิตภัณฑ์ต่างๆ ของ Google และเป็นวิธีที่ผู้ใช้พูดถึงแอปที่เชื่อมต่อโดยใช้
@เลือกถัดไป ในกล่องโต้ตอบเลือกหมวดหมู่แอปที่เชื่อมต่อ ให้เลือกโดเมน หมวดหมู่ หรืออุตสาหกรรมของแอปจากเมนูเลือกหมวดหมู่
ในกล่องโต้ตอบเลือกประเภทการเชื่อมต่อ ให้เลือก Android MCP
ดูคำแนะนำโดยละเอียดเกี่ยวกับการตั้งค่าแอปที่เชื่อมต่อกับเซิร์ฟเวอร์ MCP ได้ที่คู่มือการผสานรวม Google Connected Console ในตอนนี้ คุณเลือกประเภทการเชื่อมต่อได้เพียงประเภทเดียวต่อแอปที่เชื่อมต่อ และจะเปลี่ยนแปลงในภายหลังไม่ได้
เลือกสร้างแอปที่เชื่อมต่อ
ในกล่องโต้ตอบเลือกแอป ให้ค้นหาแอป Play ที่มี (หรือจะมี) AppFunctions แล้วเลือกแอปนั้น คุณกรองรายการได้โดยใช้การค้นหา
- คุณไม่สามารถเลือกแอป Play ที่ลิงก์กับแอปที่เชื่อมต่ออื่นอยู่แล้ว
- โปรดเลือกแอป Google Play ที่ถูกต้องซึ่งคุณต้องการลิงก์ เมื่อเลือกแอป Play แล้ว คุณจะเปลี่ยนแปลงไม่ได้
ซึ่งจะเปิดหน้าภาพรวมการจัดการสำหรับแอปที่เชื่อมต่อ ซึ่งคุณสามารถกำหนดค่ารายละเอียดแอปที่เชื่อมต่อ ติดตามเวอร์ชันแอปที่เชื่อมต่อ และจัดการผู้ทดสอบต่อไปได้
ขั้นตอนที่ 2: ระบุรายละเอียดแอปที่เชื่อมต่อ
ก่อนอัปโหลด App Bundle ที่มี AppFunctions ให้กำหนดค่าลักษณะที่แอปที่เชื่อมต่อจะปรากฏต่อผู้ใช้ใน Gemini
ทำตามขั้นตอนต่อไปนี้เพื่อระบุรายละเอียดแอปที่เชื่อมต่อ
- ในหน้าการจัดการแอปที่เชื่อมต่อ ภายในการ์ด Android MCP ในส่วนเพิ่มรายละเอียดแอปที่เชื่อมต่อ ให้เลือกเพิ่มรายละเอียดแอป (หรือจัดการหากอัปเดตรายละเอียดที่มีอยู่)
- ที่ด้านบนของหน้ารายละเอียดแอป ให้ยืนยันช่องชื่อแอปที่เชื่อมต่อ คุณอัปเดตชื่อได้หากจำเป็น ข้อมูลนี้จะแสดงต่อผู้ใช้ในผลิตภัณฑ์ต่างๆ ของ Google และจะใช้เมื่อผู้ใช้พูดถึงแอปของคุณด้วย
@ - ในส่วนรายละเอียดสาธารณะ ให้ไปที่ไอคอน แล้วอัปโหลดไอคอนแอป (JPG หรือ PNG มีขนาดสูงสุด 1 MB และความละเอียด 512 x 512 พิกเซล)
กรอกข้อมูลในฟิลด์ต่อไปนี้ให้สมบูรณ์
- คำอธิบาย: ป้อนสรุปสั้นๆ เพียงประโยคเดียว (ไม่เกิน 30 คำ) ที่อธิบายฟีเจอร์หลักของแอปที่เชื่อมต่อและสิ่งที่แอปทำได้ ข้อความนี้จะแสดงต่อผู้ใช้ และไม่ได้ใช้เป็นวิธีการของโมเดล
- ความสามารถ: ป้อนงานที่มีมูลค่าสูงอย่างน้อย 3 รายการที่แอปที่เชื่อมต่อของคุณทำได้ เลือกเพิ่มความสามารถเพื่อเพิ่มรายการอื่นๆ อย่าใส่ตัวเลขที่จุดเริ่มต้นของความสามารถ ระบุความสามารถเพียงรายการเดียวต่อรายการ หากหมวดหมู่แอปที่เชื่อมต่อมีความสามารถที่กำหนดไว้ล่วงหน้า ความสามารถเหล่านั้นจะปรากฏที่ด้านบนของรายการและแก้ไขไม่ได้
- พรอมต์ตัวอย่าง: ป้อนพรอมต์ตัวอย่างอย่างน้อย 3 รายการที่ช่วยให้ผู้ใช้เข้าใจว่าสามารถถามอะไรได้บ้าง เลือกเพิ่มพรอมต์ตัวอย่างเพื่อเพิ่มรายการ
- เริ่มพรอมต์อย่างน้อย 2 รายการด้วย
@<YourAppName>(เช่น@Order Tracker where is my last order?) - พูดถึง
<YourAppName>อย่างเป็นธรรมชาติในพรอมต์อย่างน้อย 1 รายการโดยไม่ต้องขึ้นต้นด้วยชื่อแอป (เช่นTrack my recent order on Order Tracker) - อย่าใส่คำนำหน้าที่มีตัวเลข (
1.,2.,3.) หรือใส่พรอมต์ไว้ในเครื่องหมายคำพูด ("...")
- เริ่มพรอมต์อย่างน้อย 2 รายการด้วย
การแปลหลายภาษา: หากต้องการระบุคำแปลสำหรับคำอธิบาย ความสามารถ และพรอมต์ตัวอย่าง ให้รวมข้อความของแต่ละภาษาไว้ในแท็กภาษาภายในช่องป้อนข้อมูล เช่น
<en-US> Play music, manage playlists, and discover artists </en-US> <es-ES> Reproduce música, gestiona listas y descubre artistas </es-ES>Connected Console จะตรวจสอบแท็กโดยอัตโนมัติและแสดงภาษาที่ตรวจพบในแต่ละช่อง (เช่น
Found translations for 2 languages: en-US, es-ES)URL ของข้อกำหนดในการให้บริการ: ป้อนลิงก์
https://หรือhttp://ที่ถูกต้องไปยังข้อกำหนดในการให้บริการURL ของนโยบาย: ป้อนลิงก์
https://หรือhttp://ที่ถูกต้องไปยังนโยบายความเป็นส่วนตัวURL ของเว็บไซต์ (ไม่บังคับ): ป้อนลิงก์ไปยังเว็บไซต์เพื่อวัตถุประสงค์ในการระบุแหล่งที่มา
ขั้นตอนที่ 3: อัปโหลด App Bundle ที่มี AppFunctions และส่งแอปที่เชื่อมต่อ
หลังจากบันทึกรายละเอียดแอปที่เชื่อมต่อแล้ว ให้อัปโหลด Android App Bundle ที่มี AppFunctions ไปยังแอป Play ที่ลิงก์ไว้ แล้วส่งแอปที่เชื่อมต่อเวอร์ชันดังกล่าวเข้ารับการทดสอบ
หากต้องการอัปโหลด App Bundle ที่มี AppFunctions ให้ทำตามขั้นตอนต่อไปนี้
- ในหน้าการจัดการแอปที่เชื่อมต่อ ให้ไปที่การ์ด Android MCP ในส่วนอัปโหลด App Bundle ที่มี AppFunctions แล้วเลือกอัปโหลด App Bundle เพื่อไปที่ภาพรวมทดสอบและเผยแพร่ของแอป Play ที่ลิงก์ไว้
- หรือเปิดแอป Play ที่ลิงก์ไว้โดยตรงใน Google Connected Console ในเมนูการนำทางด้านซ้ายของแอป Play ให้ไปที่การทดสอบ > การทดสอบภายใน (หรือแทร็กทดสอบอื่น) แล้วเลือกสร้างรุ่นใหม่ (หรือแก้ไขเวอร์ชันร่างหากคุณมีเวอร์ชันร่างอยู่แล้ว)
- ในส่วน App Bundle ให้เลือกอัปโหลดเพื่ออัปโหลด Bundle
.aabที่มี AppFunctions หรือเลือกเพิ่มจากคลังหากคุณอัปโหลด Bundle หลังจากทำขั้นตอนที่ 2 เสร็จแล้ว - เมื่ออัปโหลดเสร็จแล้ว ให้ไปที่ส่วนตรวจพบฟังก์ชันของแอปใน App Bundle ในหน้ารุ่น ยืนยันว่าชื่อแอปที่เชื่อมต่อ รหัสเวอร์ชันแพ็กเกจ จำนวนเครื่องมือที่ตรวจพบ จำนวนภาษา และการกำหนดเป้าหมายประเทศของแอป Play ปรากฏตามที่คาดไว้ และยืนยันว่าการตรวจสอบอัตโนมัติไม่รายงานปัญหาใดๆ (หากมีข้อผิดพลาดในการตรวจสอบปรากฏขึ้น ให้ทำตามวิธีการในหัวข้อแก้ปัญหาที่เกี่ยวข้องกับ AppFunctions ก่อนดำเนินการต่อ)
- ที่ด้านล่างของหน้ารุ่น ให้เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ
การเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อจะเป็นการส่ง AppFunctions เวอร์ชันของคุณไปยัง Gemini เพื่อทดสอบเวอร์ชันตัวอย่าง และเลื่อนรุ่นของ Play ไปยังหน้ารุ่นเวอร์ชันตัวอย่าง หากต้องการทำซ้ำ AppFunctions โดยใช้บิลด์ในเครื่องโดยไม่เพิ่มรหัสเวอร์ชันของ App Bundle ให้ปล่อยรุ่น Play ไว้ในสถานะฉบับร่าง และอย่าเลือกบันทึกและเผยแพร่ การเผยแพร่รุ่นใน Play จะล็อกรหัสเวอร์ชันของแพ็กเกจนั้นเพื่อไม่ให้ลบและอัปโหลดซ้ำได้อีก การเปลี่ยนแปลงใดๆ ในภายหลังจะต้องใช้รหัสเวอร์ชัน App Bundle ที่เพิ่มขึ้น (หากผู้ทดสอบติดตั้งแอปโดยตรงจากแทร็กทดสอบภายในของ Google Play แทนการไซด์โหลด ให้เปิดตัวการทดสอบภายในให้เสร็จสมบูรณ์และเพิ่มรหัสเวอร์ชันในการอัปโหลดในอนาคต)
ขั้นตอนที่ 4: ยืนยันเวอร์ชันของแอปที่เชื่อมต่อ
หลังจากส่งแอปที่เชื่อมต่อจากหน้าการเผยแพร่ของ Play แล้ว ให้ยืนยันว่าแอปที่เชื่อมต่อเวอร์ชันดังกล่าวพร้อมสำหรับการแสดงตัวอย่าง โดยทำดังนี้
- ในหน้าการจัดการแอปที่เชื่อมต่อ ในการ์ด Android MCP ข้างเวอร์ชัน ให้เลือกดู
- ในหน้าเวอร์ชัน ให้ยืนยันว่าเวอร์ชันที่ส่งปรากฏในส่วนพร้อมใช้งานสำหรับผู้ทดสอบ (แสดง
Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>)- เลือกดูในแถวเวอร์ชันใดก็ได้เพื่อตรวจสอบ AppFunctions ที่ตรวจพบและภาพรวมรายละเอียดแอปแบบอ่านอย่างเดียวที่บันทึกไว้สำหรับเวอร์ชันนั้น
- เวอร์ชันที่สร้างจาก App Bundle ที่อัปโหลดซึ่งคุณยังไม่ได้เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อจะปรากฏในส่วนรอดำเนินการส่ง
ขั้นตอนที่ 5: ทดสอบแอปที่เชื่อมต่อ
หากต้องการให้ผู้ทดสอบใช้งานแอปที่เชื่อมต่อได้ คุณต้องเพิ่มผู้ทดสอบในหน้าจัดการผู้ทดสอบ เฉพาะผู้ใช้ที่คุณเพิ่มลงในรายชื่อผู้ทดสอบเท่านั้นที่จะดูและโต้ตอบกับแอปที่เชื่อมต่อซึ่งยังไม่ได้เผยแพร่ได้ คุณเพิ่มได้เฉพาะผู้ทดสอบที่มีบัญชี @gmail.com เท่านั้น
แทร็กทดสอบของแอป Play มีรายชื่อผู้ทดสอบของตัวเอง ซึ่งจะควบคุมว่าใครสามารถติดตั้งบิลด์ทดสอบจาก Google Play ได้บ้าง ใช้ผู้ทดสอบรายเดียวกันสำหรับแอปที่เชื่อมต่อและแทร็กทดสอบที่มีรุ่นของคุณ
- ในหน้าภาพรวมของแอปที่เชื่อมต่อ ให้เลือกเพิ่มผู้ทดสอบ (หรือจัดการผู้ทดสอบหากเพิ่มไว้แล้ว) ในการ์ดทดสอบแอป
- ในหน้าจัดการผู้ทดสอบ ให้เลือกรายชื่ออีเมลที่มีอยู่หรือเลือกสร้างรายชื่ออีเมลเพื่อเพิ่มบัญชี Google ที่ได้รับอนุญาตให้ทดสอบการผสานรวมของคุณ อย่าลืมใส่อีเมลของคุณเองหากต้องการทดสอบแอปด้วยตนเอง
เลือกบันทึก
ในแอป Play ที่ลิงก์ไว้ ให้ไปที่แทร็กทดสอบที่มีรุ่นของคุณ (เช่น การทดสอบ > การทดสอบภายใน) เลือกแท็บผู้ทดสอบ แล้วเลือกรายชื่ออีเมลเดียวกัน
ผู้ทดสอบในแอป Gemini สามารถเรียกใช้แอปที่เชื่อมต่อของคุณได้โดยพิมพ์
@ตามด้วยชื่อแอปที่เชื่อมต่อ แล้วเลือกแอปนั้นจากเมนู นอกจากนี้ คุณยังดูและเชื่อมต่อแอปใน Gemini ได้โดยไปที่การตั้งค่าและความช่วยเหลือ > แอปที่เชื่อมต่อในแถบนำทางด้านซ้าย
ก่อนทดสอบในอุปกรณ์ โปรดยืนยันว่าผู้ทดสอบแต่ละรายมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้
- ลงชื่อเข้าใช้แอป Gemini ในโทรศัพท์หรือแท็บเล็ตที่ใช้ Android ด้วยบัญชี Google ในรายชื่อผู้ทดสอบของแอปที่เชื่อมต่อ
- เรียกใช้บิลด์แอป Android ที่ตรงกันทุกประการซึ่งมีรหัสเวอร์ชันของแพ็กเกจตรงกับเวอร์ชันที่ส่งในขั้นตอนที่ 3
เราขอแนะนำให้ทดสอบการผสานรวมอย่างละเอียด ดังนี้
- ลองใช้พรอมต์ตัวอย่างทั้งหมด
- ทดสอบทั้งการเรียกใช้
@<AppName>ที่ระบุชัดและการค้นหาด้วยภาษาธรรมชาติ - ยืนยันการจัดการพารามิเตอร์ ข้อความแจ้งเพื่อยืนยัน และการดำเนินการตั้งแต่ต้นจนจบทั้งใน AppFunction แบบอ่านและแบบเปลี่ยนสถานะ หลังจากเรียกใช้พรอมต์ที่เปลี่ยนสถานะแล้ว ให้เปิดแอปเพื่อยืนยันว่าการเปลี่ยนแปลงปรากฏใน UI ของแอป
เมื่อพอใจกับการทดสอบแล้ว คุณก็พร้อมที่จะส่งแอปที่เชื่อมต่อให้ Google ตรวจสอบ
ขั้นตอนที่ 6: เผยแพร่แอปที่เชื่อมต่อกับผู้ใช้
แอปที่เชื่อมต่อ Android MCP ไม่จำเป็นต้องมีการตรวจสอบหรือการดำเนินการเผยแพร่แยกต่างหากในหน้าการจัดการแอปที่เชื่อมต่อ ซึ่งแตกต่างจากการผสานรวม MCP ที่โฮสต์บนเซิร์ฟเวอร์ แต่ Google จะตรวจสอบเวอร์ชันแอปที่เชื่อมต่อและเผยแพร่โดยอัตโนมัติเมื่อคุณเผยแพร่เวอร์ชันแอป Play ที่มี App Bundle ของ AppFunctions ไปยังเวอร์ชันที่ใช้งานจริง
เมื่อคุณทดสอบเสร็จแล้วและพร้อมเปิดตัวให้ผู้ใช้ ให้ทำดังนี้
- ใน Google Connected Console ให้เปิดแอป Play ที่ลิงก์ไว้ แล้วไปที่รุ่น > เวอร์ชันที่ใช้งานจริงในเมนูการนำทางด้านซ้าย (หรือโปรโมตรุ่นที่ทดสอบแล้วจากแทร็กทดสอบเป็นเวอร์ชันที่ใช้งานจริง)
- เลือกสร้างรุ่นใหม่ (หรือแก้ไขรุ่นใช้งานจริงฉบับร่างที่มีอยู่) แล้วเพิ่ม App Bundle ที่มี AppFunctions ที่ยืนยันแล้วโดยใช้เพิ่มจากคลังหรืออัปโหลด
- ไปที่ส่วนตรวจพบ AppFunctions ใน App Bundle เพื่อยืนยันเวอร์ชันแอปที่เชื่อมต่อ จำนวนเครื่องมือ จำนวนภาษาของข้อมูลผลิตภัณฑ์ใน Store และการกำหนดเป้าหมายประเทศของแอป Play รวมถึงตรวจสอบว่าการตรวจสอบอัตโนมัติไม่แสดงปัญหาที่บล็อกอยู่
- เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ กรอกรายละเอียดรุ่นให้ครบถ้วน แล้วส่งรุ่นที่ใช้งานจริงของแอป Play เพื่อรับการตรวจสอบและการเปิดตัว
เมื่อรุ่นใช้งานจริงของแอป Play ได้รับอนุมัติและเปิดตัวแล้ว ให้ทำดังนี้
- แอปที่เชื่อมต่อ Android MCP จะพร้อมใช้งานใน Gemini บน Android สำหรับผู้ใช้ในประเทศและภาษาที่แอป Play ของคุณกำหนดเป้าหมาย
- ในหน้าการจัดการแอปที่เชื่อมต่อ (แอปที่เชื่อมต่อ > จัดการ) การ์ดสถานะแอปที่เชื่อมต่อจะอัปเดตเป็นเผยแพร่แล้ว โดยแสดงรหัสเวอร์ชันและวันที่เผยแพร่ของ App Bundle ที่เผยแพร่อยู่ และเวอร์ชันจะปรากฏในส่วนเผยแพร่แล้วในหน้าเวอร์ชัน
- หากต้องการจัดส่งเครื่องมือ AppFunctions ที่อัปเดตในภายหลัง ให้สร้าง App Bundle ใหม่ที่มีรหัสเวอร์ชันที่เพิ่มขึ้น ทดสอบโดยใช้แทร็กทดสอบ และเผยแพร่รุ่น Play เวอร์ชันที่ใช้งานจริงใหม่ หากต้องการอัปเดตข้อมูลเมตาสาธารณะของแอปที่เชื่อมต่อด้วย (เช่น ความสามารถหรือพรอมต์ตัวอย่าง) ให้บันทึกการแก้ไขเหล่านั้นในส่วนแอปที่เชื่อมต่อ > จัดการ > รายละเอียดแอปก่อนอัปโหลด App Bundle ใหม่
อัปเดต App Bundle เพื่อปรับ AppFunctions
หากต้องการทำซ้ำ AppFunctions ในระหว่างการทดสอบภายในโดยไม่เพิ่มรหัสเวอร์ชันของแอป Android คุณสามารถนำ App Bundle ฉบับร่างที่ยังไม่ได้เผยแพร่ออกและลบก่อนที่จะอัปโหลดซ้ำได้ โดยทำดังนี้
- อัปเดตการใช้งาน AppFunctions ในโปรเจ็กต์ Android และสร้าง App Bundle
.aabใหม่ - นำ App Bundle ก่อนหน้าออกจากเวอร์ชันร่างที่คุณเพิ่มไว้ โดยทำดังนี้
- เปิดแอป Google Play ที่ลิงก์ไว้ใน Google Connected Console แล้วเลือกการทดสอบภายใน (หรือแทร็กที่มีเวอร์ชันร่าง) ในเมนูการนำทางด้านซ้าย
- ในเวอร์ชันร่าง ให้เลือกแก้ไขรุ่น
- ค้นหา App Bundle แล้วเลือกเมนู 3 จุด (⋮) จากนั้นเลือกนำ App Bundle ออก
- เลือกบันทึกเป็นฉบับร่าง
- ลบ App Bundle ที่ไม่ได้ใช้ออกจากคลัง โดยทำดังนี้
- ในเมนูการนำทางด้านซ้ายของแอป Play ให้เลือกรุ่นและแพ็กเกจล่าสุด (หากไม่เห็นแพ็กเกจแสดงอยู่ ให้เลือกดู App Bundle ทั้งหมด)
- เปิดรายละเอียดของ App Bundle และหากมีปุ่มลบ App Bundle ให้เลือกลบ App Bundle ซึ่งจะทำให้รหัสเวอร์ชันว่างลง คุณจึงอัปโหลด App Bundle ที่อัปเดตแล้วได้โดยไม่ต้องเพิ่มรหัสเวอร์ชัน
- หากลบ App Bundle ไม่ได้ (เช่น เนื่องจากรุ่นได้รับการเผยแพร่ไปยังแทร็กแล้ว) ให้เพิ่ม
versionCodeในการกำหนดค่าบิลด์ของแอป สร้าง App Bundle ใหม่ แล้วอัปโหลดและส่งเวอร์ชันใหม่ตามที่อธิบายไว้ในขั้นตอนที่ 3
แก้ปัญหาที่เกี่ยวข้องกับ AppFunctions
ใช้คำแนะนำต่อไปนี้เพื่อแก้ไขข้อผิดพลาดในการตรวจสอบอัตโนมัติและปัญหาการตั้งค่าที่พบบ่อย
แก้ไขข้อผิดพลาดในการตรวจสอบอัตโนมัติในรุ่น
ปัญหาที่พบจากการตรวจสอบ AppFunctions อัตโนมัติจะปรากฏในหน้าการเตรียมการเผยแพร่ (เช่น สร้างรุ่นการทดสอบภายใน) และในส่วนไม่สำเร็จ (พร้อมป้ายแก้ไขปัญหาเพื่อเผยแพร่) ในหน้าเวอร์ชันของแอปที่เชื่อมต่อ
หากการตรวจสอบอัตโนมัติรายงานปัญหาเกี่ยวกับ App Bundle ให้ทำตามขั้นตอนต่อไปนี้
- แก้ไขปัญหา AppFunctions ที่สำคัญในโค้ดของแอป Android และสร้าง App Bundle ที่อัปเดตแล้ว
- หากรุ่นก่อนหน้ายังคงเป็นฉบับร่างและคุณต้องการใช้รหัสเวอร์ชันเดิมซ้ำ ให้ทำดังนี้
- ในเมนูการนำทางด้านซ้ายของแอป Play ให้เลือกการทดสอบภายใน (หรือแทร็กที่เกี่ยวข้อง) แล้วเลือกแก้ไขรุ่นในเวอร์ชันร่างของคุณ
- เลือกเมนู 3 จุด (⋮) ข้าง App Bundle แล้วเลือกนำ App Bundle ออก
- เลือกบันทึกเป็นฉบับร่าง
- ในเมนูการนำทางด้านซ้าย ให้เลือกรุ่นและแพ็กเกจล่าสุด (เลือกดู App Bundle ทั้งหมดหากจำเป็น) เลือกแพ็กเกจ แล้วเลือกลบ App Bundle
- กลับไปที่เวอร์ชันร่าง อัปโหลด App Bundle ที่แก้ไขแล้ว แล้วเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ
- หากลบแพ็กเกจก่อนหน้าไม่ได้ ให้เพิ่ม
versionCodeของ App Bundle, อัปโหลดแพ็กเกจใหม่ไปยังรุ่น แล้วเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ
ปัญหาที่พบได้ทั่วไปเกี่ยวกับการตั้งค่าและการผสานรวม
ตารางต่อไปนี้อธิบายปัญหาที่พบบ่อยซึ่งคุณอาจพบระหว่างการตั้งค่าแอปที่เชื่อมต่อ การอัปโหลดแพ็กเกจ หรือการทดสอบ รวมถึงสาเหตุและวิธีแก้ไข
| ปัญหา | ข้อความในคอนโซลหรืออาการ | สาเหตุ | ความละเอียด |
|---|---|---|---|
| App Bundle ที่อัปโหลดก่อนสร้างหรือลิงก์แอปที่เชื่อมต่อ | หน้ารุ่นจะแสดงสร้างหรือลิงก์แอปที่เชื่อมต่อ | .aab ที่อัปโหลดมี AppFunctions แต่แอป Google Play ยังไม่ได้ลิงก์กับแอปที่เชื่อมต่อ Android MCP |
ทำขั้นตอนที่ 1 ถึงขั้นตอนที่ 3 ให้เสร็จสมบูรณ์เพื่อสร้างแอปที่เชื่อมต่อ เลือก Android MCP ลิงก์แอป Play และบันทึกรายละเอียดแอป จากนั้นให้ลบและอัปโหลด App Bundle อีกครั้ง หรืออัปโหลด Bundle ใหม่ที่มี versionCode ที่เพิ่มขึ้น |
| App Bundle ที่อัปโหลดก่อนบันทึกรายละเอียดแอปที่เชื่อมต่อ | หน้ารุ่นจะแสดงข้อความต้องระบุรายละเอียดแอปที่เชื่อมต่อและปุ่มระบุรายละเอียดแอปที่เชื่อมต่อ | แอป Google Play ลิงก์กับแอปที่เชื่อมต่อ Android MCP แต่ไม่ได้บันทึกช่องที่ต้องกรอกในหน้ารายละเอียดแอปก่อนอัปโหลด Bundle | เลือกระบุรายละเอียดแอปที่เชื่อมต่อ (หรือไปที่แอปที่เชื่อมต่อ > จัดการ > เพิ่มรายละเอียดแอป) กรอกข้อมูลและบันทึกช่องที่ต้องกรอกทั้งหมด จากนั้นลบและอัปโหลด Bundle อีกครั้ง หรืออัปโหลด Bundle ใหม่ที่มี versionCode ที่เพิ่มขึ้น |
| เลือกแอป Google Play ไม่ได้เมื่อลิงก์ | แอป Play เป้าหมายแสดงป้ายลิงก์แล้วหรือไม่ปรากฏในกล่องโต้ตอบเลือกแอป | แอป Play แต่ละแอปจะลิงก์กับแอปที่เชื่อมต่อ Android MCP ได้เพียงแอปเดียวเท่านั้น หรือแอป Play ยังไม่ได้สร้างในบัญชีนักพัฒนาแอปนี้ | ตรวจสอบรายการที่มีอยู่ส่วนแอปที่เชื่อมต่อเพื่อดูว่ามีแอปที่เชื่อมต่ออื่นลิงก์กับแอป Play ของคุณอยู่แล้วหรือไม่ หรือสร้างแอป Play ใน Google Connected Console ก่อนลิงก์ |
| สร้างแอปที่เชื่อมต่อไม่ได้ | ไม่มีตัวเลือกในการสร้างแอปที่เชื่อมต่อ หรือการสร้างแอปที่เชื่อมต่อแสดงคำเตือนเกี่ยวกับสิทธิ์หรือข้อกำหนดในการให้บริการ | บัญชีผู้ใช้ของคุณไม่มีสิทธิ์ของแอปที่เชื่อมต่อ หรือเจ้าของบัญชีหรือผู้ดูแลระบบยังไม่ได้ยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อ | ขอให้เจ้าของบัญชีหรือผู้ดูแลระบบยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อและให้สิทธิ์บัญชีของคุณในการดูแอปที่เชื่อมต่อหรือสร้างและจัดการแอปที่เชื่อมต่อในหน้าผู้ใช้และสิทธิ์ |
| เวอร์ชันแอปที่เชื่อมต่อค้างอยู่ที่สถานะ "รอดำเนินการส่ง" | ในส่วนแอปที่เชื่อมต่อ > จัดการ > เวอร์ชัน เวอร์ชันแพ็กเกจจะปรากฏในส่วนรอการส่งแทนพร้อมให้ผู้ทดสอบใช้งาน | Google Connected Console ตรวจพบ AppFunctions ในแพ็กเกจที่คุณอัปโหลด แต่ยังไม่ได้ส่งเวอร์ชันแอปที่เชื่อมต่อจากหน้าการเผยแพร่ | เปิดรุ่นของแอป Play ที่มี Bundle นั้น แล้วเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อเพื่อให้ผู้ทดสอบดูตัวอย่างได้ |
| ตัวอย่างข้อผิดพลาดในการตรวจสอบพรอมต์ในหน้ารายละเอียดแอป | บันทึกแบบฟอร์มการ์ดแอปสาธารณะไม่ได้ และแสดงข้อผิดพลาดในส่วนพรอมต์ตัวอย่าง | พรอมต์ไม่เป็นไปตามกฎการจัดรูปแบบหรือการพูดถึง หรือมีการแก้ไขชื่อแอปหลังจากเขียนพรอมต์ | ระบุพรอมต์ทั้งหมด 3-4 รายการ โดยเริ่มอย่างน้อย 2 รายการด้วย @<YourAppName> พูดถึง <YourAppName> อย่างเป็นธรรมชาติโดยไม่มี @ ในอย่างน้อย 1 รายการ และนำคำนำหน้าที่มีตัวเลข (1., 2.) หรือเครื่องหมายคำพูดที่ล้อมรอบ ("...") ออก |
| ผู้ทดสอบไม่เห็นแอปที่เชื่อมต่อใน Gemini บน Android | ผู้ทดสอบไม่พบแอปที่เชื่อมต่อในส่วนแอปที่เชื่อมต่อ หรือใช้การพูดถึง @ ในแอป Gemini บน Android |
การเผยแพร่ยังอยู่ระหว่างดำเนินการ บัญชีผู้ทดสอบไม่มีสิทธิ์ หรือเวอร์ชัน Installed App ที่ติดตั้งไม่ตรงกัน | รอประมาณ 20 นาทีหลังจากส่ง (และรอไม่เกิน 10 นาทีหลังจากบันทึกผู้ทดสอบ) ตรวจสอบว่าบัญชี @gmail.com ส่วนตัวของผู้ทดสอบอยู่ในรายชื่อผู้ทดสอบของแอปที่เชื่อมต่อ ไม่ใช่แค่ในแทร็กทดสอบของแอป Play เท่านั้น รวมถึงยืนยันว่าผู้ทดสอบใช้โทรศัพท์หรือแท็บเล็ตที่ใช้ Android และได้ติดตั้ง Bundle เวอร์ชันเดียวกับที่ส่งมา |