สร้างและจัดการแอปที่เชื่อมต่อด้วย AppFunctions ใน Google Connected Console

ใช้ 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 ให้ทำตามขั้นตอนต่อไปนี้

  1. ลงชื่อเข้าใช้ Google Connected Console
  2. ในหน้าแรก ให้เลือกสร้างแอป
  3. ในกล่องโต้ตอบเลือกสิ่งที่ต้องการสร้าง ให้ทำดังนี้
    • หากได้รับข้อความแจ้งให้ยอมรับข้อกำหนดในการให้บริการของแอปที่เชื่อมต่อ ให้เลือกดูข้อกำหนด อ่านและยอมรับข้อตกลง แล้วเลือกสร้าง มีเพียงผู้ดูแลระบบบัญชีเท่านั้นที่ยอมรับข้อตกลงได้
    • หรือเลือกสร้างในการ์ดแอปที่เชื่อมต่อ
  4. ในกล่องโต้ตอบตั้งชื่อแอปที่เชื่อมต่อ ให้พิมพ์ชื่อแอปที่เชื่อมต่อ ซึ่งเป็นชื่อที่แสดงแอปที่เชื่อมต่อในผลิตภัณฑ์ต่างๆ ของ Google และเป็นวิธีที่ผู้ใช้พูดถึงแอปที่เชื่อมต่อโดยใช้ @ เลือกถัดไป
  5. ในกล่องโต้ตอบเลือกหมวดหมู่แอปที่เชื่อมต่อ ให้เลือกโดเมน หมวดหมู่ หรืออุตสาหกรรมของแอปจากเมนูเลือกหมวดหมู่

  6. ในกล่องโต้ตอบเลือกประเภทการเชื่อมต่อ ให้เลือก Android MCP

    ดูคำแนะนำโดยละเอียดเกี่ยวกับการตั้งค่าแอปที่เชื่อมต่อกับเซิร์ฟเวอร์ MCP ได้ที่คู่มือการผสานรวม Google Connected Console ในตอนนี้ คุณเลือกประเภทการเชื่อมต่อได้เพียงประเภทเดียวต่อแอปที่เชื่อมต่อ และจะเปลี่ยนแปลงในภายหลังไม่ได้

  7. เลือกสร้างแอปที่เชื่อมต่อ

  8. ในกล่องโต้ตอบเลือกแอป ให้ค้นหาแอป Play ที่มี (หรือจะมี) AppFunctions แล้วเลือกแอปนั้น คุณกรองรายการได้โดยใช้การค้นหา

    • คุณไม่สามารถเลือกแอป Play ที่ลิงก์กับแอปที่เชื่อมต่ออื่นอยู่แล้ว
    • โปรดเลือกแอป Google Play ที่ถูกต้องซึ่งคุณต้องการลิงก์ เมื่อเลือกแอป Play แล้ว คุณจะเปลี่ยนแปลงไม่ได้

ซึ่งจะเปิดหน้าภาพรวมการจัดการสำหรับแอปที่เชื่อมต่อ ซึ่งคุณสามารถกำหนดค่ารายละเอียดแอปที่เชื่อมต่อ ติดตามเวอร์ชันแอปที่เชื่อมต่อ และจัดการผู้ทดสอบต่อไปได้

ขั้นตอนที่ 2: ระบุรายละเอียดแอปที่เชื่อมต่อ

ก่อนอัปโหลด App Bundle ที่มี AppFunctions ให้กำหนดค่าลักษณะที่แอปที่เชื่อมต่อจะปรากฏต่อผู้ใช้ใน Gemini

ทำตามขั้นตอนต่อไปนี้เพื่อระบุรายละเอียดแอปที่เชื่อมต่อ

  1. ในหน้าการจัดการแอปที่เชื่อมต่อ ภายในการ์ด Android MCP ในส่วนเพิ่มรายละเอียดแอปที่เชื่อมต่อ ให้เลือกเพิ่มรายละเอียดแอป (หรือจัดการหากอัปเดตรายละเอียดที่มีอยู่)
  2. ที่ด้านบนของหน้ารายละเอียดแอป ให้ยืนยันช่องชื่อแอปที่เชื่อมต่อ คุณอัปเดตชื่อได้หากจำเป็น ข้อมูลนี้จะแสดงต่อผู้ใช้ในผลิตภัณฑ์ต่างๆ ของ Google และจะใช้เมื่อผู้ใช้พูดถึงแอปของคุณด้วย @
  3. ในส่วนรายละเอียดสาธารณะ ให้ไปที่ไอคอน แล้วอัปโหลดไอคอนแอป (JPG หรือ PNG มีขนาดสูงสุด 1 MB และความละเอียด 512 x 512 พิกเซล)
  4. กรอกข้อมูลในฟิลด์ต่อไปนี้ให้สมบูรณ์

    • คำอธิบาย: ป้อนสรุปสั้นๆ เพียงประโยคเดียว (ไม่เกิน 30 คำ) ที่อธิบายฟีเจอร์หลักของแอปที่เชื่อมต่อและสิ่งที่แอปทำได้ ข้อความนี้จะแสดงต่อผู้ใช้ และไม่ได้ใช้เป็นวิธีการของโมเดล
    • ความสามารถ: ป้อนงานที่มีมูลค่าสูงอย่างน้อย 3 รายการที่แอปที่เชื่อมต่อของคุณทำได้ เลือกเพิ่มความสามารถเพื่อเพิ่มรายการอื่นๆ อย่าใส่ตัวเลขที่จุดเริ่มต้นของความสามารถ ระบุความสามารถเพียงรายการเดียวต่อรายการ หากหมวดหมู่แอปที่เชื่อมต่อมีความสามารถที่กำหนดไว้ล่วงหน้า ความสามารถเหล่านั้นจะปรากฏที่ด้านบนของรายการและแก้ไขไม่ได้
    • พรอมต์ตัวอย่าง: ป้อนพรอมต์ตัวอย่างอย่างน้อย 3 รายการที่ช่วยให้ผู้ใช้เข้าใจว่าสามารถถามอะไรได้บ้าง เลือกเพิ่มพรอมต์ตัวอย่างเพื่อเพิ่มรายการ
      • เริ่มพรอมต์อย่างน้อย 2 รายการด้วย @<YourAppName> (เช่น @Order Tracker where is my last order?)
      • พูดถึง <YourAppName> อย่างเป็นธรรมชาติในพรอมต์อย่างน้อย 1 รายการโดยไม่ต้องขึ้นต้นด้วยชื่อแอป (เช่น Track my recent order on Order Tracker)
      • อย่าใส่คำนำหน้าที่มีตัวเลข (1., 2., 3.) หรือใส่พรอมต์ไว้ในเครื่องหมายคำพูด ("...")
    • การแปลหลายภาษา: หากต้องการระบุคำแปลสำหรับคำอธิบาย ความสามารถ และพรอมต์ตัวอย่าง ให้รวมข้อความของแต่ละภาษาไว้ในแท็กภาษาภายในช่องป้อนข้อมูล เช่น

      <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 ให้ทำตามขั้นตอนต่อไปนี้

  1. ในหน้าการจัดการแอปที่เชื่อมต่อ ให้ไปที่การ์ด Android MCP ในส่วนอัปโหลด App Bundle ที่มี AppFunctions แล้วเลือกอัปโหลด App Bundle เพื่อไปที่ภาพรวมทดสอบและเผยแพร่ของแอป Play ที่ลิงก์ไว้
  2. หรือเปิดแอป Play ที่ลิงก์ไว้โดยตรงใน Google Connected Console ในเมนูการนำทางด้านซ้ายของแอป Play ให้ไปที่การทดสอบ > การทดสอบภายใน (หรือแทร็กทดสอบอื่น) แล้วเลือกสร้างรุ่นใหม่ (หรือแก้ไขเวอร์ชันร่างหากคุณมีเวอร์ชันร่างอยู่แล้ว)
  3. ในส่วน App Bundle ให้เลือกอัปโหลดเพื่ออัปโหลด Bundle .aab ที่มี AppFunctions หรือเลือกเพิ่มจากคลังหากคุณอัปโหลด Bundle หลังจากทำขั้นตอนที่ 2 เสร็จแล้ว
  4. เมื่ออัปโหลดเสร็จแล้ว ให้ไปที่ส่วนตรวจพบฟังก์ชันของแอปใน App Bundle ในหน้ารุ่น ยืนยันว่าชื่อแอปที่เชื่อมต่อ รหัสเวอร์ชันแพ็กเกจ จำนวนเครื่องมือที่ตรวจพบ จำนวนภาษา และการกำหนดเป้าหมายประเทศของแอป Play ปรากฏตามที่คาดไว้ และยืนยันว่าการตรวจสอบอัตโนมัติไม่รายงานปัญหาใดๆ (หากมีข้อผิดพลาดในการตรวจสอบปรากฏขึ้น ให้ทำตามวิธีการในหัวข้อแก้ปัญหาที่เกี่ยวข้องกับ AppFunctions ก่อนดำเนินการต่อ)
  5. ที่ด้านล่างของหน้ารุ่น ให้เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ

การเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อจะเป็นการส่ง AppFunctions เวอร์ชันของคุณไปยัง Gemini เพื่อทดสอบเวอร์ชันตัวอย่าง และเลื่อนรุ่นของ Play ไปยังหน้ารุ่นเวอร์ชันตัวอย่าง หากต้องการทำซ้ำ AppFunctions โดยใช้บิลด์ในเครื่องโดยไม่เพิ่มรหัสเวอร์ชันของ App Bundle ให้ปล่อยรุ่น Play ไว้ในสถานะฉบับร่าง และอย่าเลือกบันทึกและเผยแพร่ การเผยแพร่รุ่นใน Play จะล็อกรหัสเวอร์ชันของแพ็กเกจนั้นเพื่อไม่ให้ลบและอัปโหลดซ้ำได้อีก การเปลี่ยนแปลงใดๆ ในภายหลังจะต้องใช้รหัสเวอร์ชัน App Bundle ที่เพิ่มขึ้น (หากผู้ทดสอบติดตั้งแอปโดยตรงจากแทร็กทดสอบภายในของ Google Play แทนการไซด์โหลด ให้เปิดตัวการทดสอบภายในให้เสร็จสมบูรณ์และเพิ่มรหัสเวอร์ชันในการอัปโหลดในอนาคต)

ขั้นตอนที่ 4: ยืนยันเวอร์ชันของแอปที่เชื่อมต่อ

หลังจากส่งแอปที่เชื่อมต่อจากหน้าการเผยแพร่ของ Play แล้ว ให้ยืนยันว่าแอปที่เชื่อมต่อเวอร์ชันดังกล่าวพร้อมสำหรับการแสดงตัวอย่าง โดยทำดังนี้

  1. ในหน้าการจัดการแอปที่เชื่อมต่อ ในการ์ด Android MCP ข้างเวอร์ชัน ให้เลือกดู
  2. ในหน้าเวอร์ชัน ให้ยืนยันว่าเวอร์ชันที่ส่งปรากฏในส่วนพร้อมใช้งานสำหรับผู้ทดสอบ (แสดง Version <N> • Submitted <Date> • Using AppFunctions from app bundle <versionCode>)
    • เลือกดูในแถวเวอร์ชันใดก็ได้เพื่อตรวจสอบ AppFunctions ที่ตรวจพบและภาพรวมรายละเอียดแอปแบบอ่านอย่างเดียวที่บันทึกไว้สำหรับเวอร์ชันนั้น
    • เวอร์ชันที่สร้างจาก App Bundle ที่อัปโหลดซึ่งคุณยังไม่ได้เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อจะปรากฏในส่วนรอดำเนินการส่ง

ขั้นตอนที่ 5: ทดสอบแอปที่เชื่อมต่อ

หากต้องการให้ผู้ทดสอบใช้งานแอปที่เชื่อมต่อได้ คุณต้องเพิ่มผู้ทดสอบในหน้าจัดการผู้ทดสอบ เฉพาะผู้ใช้ที่คุณเพิ่มลงในรายชื่อผู้ทดสอบเท่านั้นที่จะดูและโต้ตอบกับแอปที่เชื่อมต่อซึ่งยังไม่ได้เผยแพร่ได้ คุณเพิ่มได้เฉพาะผู้ทดสอบที่มีบัญชี @gmail.com เท่านั้น

แทร็กทดสอบของแอป Play มีรายชื่อผู้ทดสอบของตัวเอง ซึ่งจะควบคุมว่าใครสามารถติดตั้งบิลด์ทดสอบจาก Google Play ได้บ้าง ใช้ผู้ทดสอบรายเดียวกันสำหรับแอปที่เชื่อมต่อและแทร็กทดสอบที่มีรุ่นของคุณ

  1. ในหน้าภาพรวมของแอปที่เชื่อมต่อ ให้เลือกเพิ่มผู้ทดสอบ (หรือจัดการผู้ทดสอบหากเพิ่มไว้แล้ว) ในการ์ดทดสอบแอป
  2. ในหน้าจัดการผู้ทดสอบ ให้เลือกรายชื่ออีเมลที่มีอยู่หรือเลือกสร้างรายชื่ออีเมลเพื่อเพิ่มบัญชี Google ที่ได้รับอนุญาตให้ทดสอบการผสานรวมของคุณ อย่าลืมใส่อีเมลของคุณเองหากต้องการทดสอบแอปด้วยตนเอง
  3. เลือกบันทึก

  4. ในแอป Play ที่ลิงก์ไว้ ให้ไปที่แทร็กทดสอบที่มีรุ่นของคุณ (เช่น การทดสอบ > การทดสอบภายใน) เลือกแท็บผู้ทดสอบ แล้วเลือกรายชื่ออีเมลเดียวกัน

  5. ผู้ทดสอบในแอป Gemini สามารถเรียกใช้แอปที่เชื่อมต่อของคุณได้โดยพิมพ์ @ ตามด้วยชื่อแอปที่เชื่อมต่อ แล้วเลือกแอปนั้นจากเมนู นอกจากนี้ คุณยังดูและเชื่อมต่อแอปใน Gemini ได้โดยไปที่การตั้งค่าและความช่วยเหลือ > แอปที่เชื่อมต่อในแถบนำทางด้านซ้าย

ก่อนทดสอบในอุปกรณ์ โปรดยืนยันว่าผู้ทดสอบแต่ละรายมีคุณสมบัติตรงตามข้อกำหนดต่อไปนี้

  • ลงชื่อเข้าใช้แอป Gemini ในโทรศัพท์หรือแท็บเล็ตที่ใช้ Android ด้วยบัญชี Google ในรายชื่อผู้ทดสอบของแอปที่เชื่อมต่อ
  • เรียกใช้บิลด์แอป Android ที่ตรงกันทุกประการซึ่งมีรหัสเวอร์ชันของแพ็กเกจตรงกับเวอร์ชันที่ส่งในขั้นตอนที่ 3

เราขอแนะนำให้ทดสอบการผสานรวมอย่างละเอียด ดังนี้

  • ลองใช้พรอมต์ตัวอย่างทั้งหมด
  • ทดสอบทั้งการเรียกใช้ @<AppName> ที่ระบุชัดและการค้นหาด้วยภาษาธรรมชาติ
  • ยืนยันการจัดการพารามิเตอร์ ข้อความแจ้งเพื่อยืนยัน และการดำเนินการตั้งแต่ต้นจนจบทั้งใน AppFunction แบบอ่านและแบบเปลี่ยนสถานะ หลังจากเรียกใช้พรอมต์ที่เปลี่ยนสถานะแล้ว ให้เปิดแอปเพื่อยืนยันว่าการเปลี่ยนแปลงปรากฏใน UI ของแอป

เมื่อพอใจกับการทดสอบแล้ว คุณก็พร้อมที่จะส่งแอปที่เชื่อมต่อให้ Google ตรวจสอบ

ขั้นตอนที่ 6: เผยแพร่แอปที่เชื่อมต่อกับผู้ใช้

แอปที่เชื่อมต่อ Android MCP ไม่จำเป็นต้องมีการตรวจสอบหรือการดำเนินการเผยแพร่แยกต่างหากในหน้าการจัดการแอปที่เชื่อมต่อ ซึ่งแตกต่างจากการผสานรวม MCP ที่โฮสต์บนเซิร์ฟเวอร์ แต่ Google จะตรวจสอบเวอร์ชันแอปที่เชื่อมต่อและเผยแพร่โดยอัตโนมัติเมื่อคุณเผยแพร่เวอร์ชันแอป Play ที่มี App Bundle ของ AppFunctions ไปยังเวอร์ชันที่ใช้งานจริง

เมื่อคุณทดสอบเสร็จแล้วและพร้อมเปิดตัวให้ผู้ใช้ ให้ทำดังนี้

  1. ใน Google Connected Console ให้เปิดแอป Play ที่ลิงก์ไว้ แล้วไปที่รุ่น > เวอร์ชันที่ใช้งานจริงในเมนูการนำทางด้านซ้าย (หรือโปรโมตรุ่นที่ทดสอบแล้วจากแทร็กทดสอบเป็นเวอร์ชันที่ใช้งานจริง)
  2. เลือกสร้างรุ่นใหม่ (หรือแก้ไขรุ่นใช้งานจริงฉบับร่างที่มีอยู่) แล้วเพิ่ม App Bundle ที่มี AppFunctions ที่ยืนยันแล้วโดยใช้เพิ่มจากคลังหรืออัปโหลด
  3. ไปที่ส่วนตรวจพบ AppFunctions ใน App Bundle เพื่อยืนยันเวอร์ชันแอปที่เชื่อมต่อ จำนวนเครื่องมือ จำนวนภาษาของข้อมูลผลิตภัณฑ์ใน Store และการกำหนดเป้าหมายประเทศของแอป Play รวมถึงตรวจสอบว่าการตรวจสอบอัตโนมัติไม่แสดงปัญหาที่บล็อกอยู่
  4. เลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ กรอกรายละเอียดรุ่นให้ครบถ้วน แล้วส่งรุ่นที่ใช้งานจริงของแอป Play เพื่อรับการตรวจสอบและการเปิดตัว

เมื่อรุ่นใช้งานจริงของแอป Play ได้รับอนุมัติและเปิดตัวแล้ว ให้ทำดังนี้

  • แอปที่เชื่อมต่อ Android MCP จะพร้อมใช้งานใน Gemini บน Android สำหรับผู้ใช้ในประเทศและภาษาที่แอป Play ของคุณกำหนดเป้าหมาย
  • ในหน้าการจัดการแอปที่เชื่อมต่อ (แอปที่เชื่อมต่อ > จัดการ) การ์ดสถานะแอปที่เชื่อมต่อจะอัปเดตเป็นเผยแพร่แล้ว โดยแสดงรหัสเวอร์ชันและวันที่เผยแพร่ของ App Bundle ที่เผยแพร่อยู่ และเวอร์ชันจะปรากฏในส่วนเผยแพร่แล้วในหน้าเวอร์ชัน
  • หากต้องการจัดส่งเครื่องมือ AppFunctions ที่อัปเดตในภายหลัง ให้สร้าง App Bundle ใหม่ที่มีรหัสเวอร์ชันที่เพิ่มขึ้น ทดสอบโดยใช้แทร็กทดสอบ และเผยแพร่รุ่น Play เวอร์ชันที่ใช้งานจริงใหม่ หากต้องการอัปเดตข้อมูลเมตาสาธารณะของแอปที่เชื่อมต่อด้วย (เช่น ความสามารถหรือพรอมต์ตัวอย่าง) ให้บันทึกการแก้ไขเหล่านั้นในส่วนแอปที่เชื่อมต่อ > จัดการ > รายละเอียดแอปก่อนอัปโหลด App Bundle ใหม่

อัปเดต App Bundle เพื่อปรับ AppFunctions

หากต้องการทำซ้ำ AppFunctions ในระหว่างการทดสอบภายในโดยไม่เพิ่มรหัสเวอร์ชันของแอป Android คุณสามารถนำ App Bundle ฉบับร่างที่ยังไม่ได้เผยแพร่ออกและลบก่อนที่จะอัปโหลดซ้ำได้ โดยทำดังนี้

  1. อัปเดตการใช้งาน AppFunctions ในโปรเจ็กต์ Android และสร้าง App Bundle .aab ใหม่
  2. นำ App Bundle ก่อนหน้าออกจากเวอร์ชันร่างที่คุณเพิ่มไว้ โดยทำดังนี้
    1. เปิดแอป Google Play ที่ลิงก์ไว้ใน Google Connected Console แล้วเลือกการทดสอบภายใน (หรือแทร็กที่มีเวอร์ชันร่าง) ในเมนูการนำทางด้านซ้าย
    2. ในเวอร์ชันร่าง ให้เลือกแก้ไขรุ่น
    3. ค้นหา App Bundle แล้วเลือกเมนู 3 จุด (⋮) จากนั้นเลือกนำ App Bundle ออก
    4. เลือกบันทึกเป็นฉบับร่าง
  3. ลบ App Bundle ที่ไม่ได้ใช้ออกจากคลัง โดยทำดังนี้
    1. ในเมนูการนำทางด้านซ้ายของแอป Play ให้เลือกรุ่นและแพ็กเกจล่าสุด (หากไม่เห็นแพ็กเกจแสดงอยู่ ให้เลือกดู App Bundle ทั้งหมด)
    2. เปิดรายละเอียดของ App Bundle และหากมีปุ่มลบ App Bundle ให้เลือกลบ App Bundle ซึ่งจะทำให้รหัสเวอร์ชันว่างลง คุณจึงอัปโหลด App Bundle ที่อัปเดตแล้วได้โดยไม่ต้องเพิ่มรหัสเวอร์ชัน
  4. หากลบ App Bundle ไม่ได้ (เช่น เนื่องจากรุ่นได้รับการเผยแพร่ไปยังแทร็กแล้ว) ให้เพิ่ม versionCode ในการกำหนดค่าบิลด์ของแอป สร้าง App Bundle ใหม่ แล้วอัปโหลดและส่งเวอร์ชันใหม่ตามที่อธิบายไว้ในขั้นตอนที่ 3

แก้ปัญหาที่เกี่ยวข้องกับ AppFunctions

ใช้คำแนะนำต่อไปนี้เพื่อแก้ไขข้อผิดพลาดในการตรวจสอบอัตโนมัติและปัญหาการตั้งค่าที่พบบ่อย

แก้ไขข้อผิดพลาดในการตรวจสอบอัตโนมัติในรุ่น

ปัญหาที่พบจากการตรวจสอบ AppFunctions อัตโนมัติจะปรากฏในหน้าการเตรียมการเผยแพร่ (เช่น สร้างรุ่นการทดสอบภายใน) และในส่วนไม่สำเร็จ (พร้อมป้ายแก้ไขปัญหาเพื่อเผยแพร่) ในหน้าเวอร์ชันของแอปที่เชื่อมต่อ

หากการตรวจสอบอัตโนมัติรายงานปัญหาเกี่ยวกับ App Bundle ให้ทำตามขั้นตอนต่อไปนี้

  1. แก้ไขปัญหา AppFunctions ที่สำคัญในโค้ดของแอป Android และสร้าง App Bundle ที่อัปเดตแล้ว
  2. หากรุ่นก่อนหน้ายังคงเป็นฉบับร่างและคุณต้องการใช้รหัสเวอร์ชันเดิมซ้ำ ให้ทำดังนี้
    1. ในเมนูการนำทางด้านซ้ายของแอป Play ให้เลือกการทดสอบภายใน (หรือแทร็กที่เกี่ยวข้อง) แล้วเลือกแก้ไขรุ่นในเวอร์ชันร่างของคุณ
    2. เลือกเมนู 3 จุด (⋮) ข้าง App Bundle แล้วเลือกนำ App Bundle ออก
    3. เลือกบันทึกเป็นฉบับร่าง
    4. ในเมนูการนำทางด้านซ้าย ให้เลือกรุ่นและแพ็กเกจล่าสุด (เลือกดู App Bundle ทั้งหมดหากจำเป็น) เลือกแพ็กเกจ แล้วเลือกลบ App Bundle
    5. กลับไปที่เวอร์ชันร่าง อัปโหลด App Bundle ที่แก้ไขแล้ว แล้วเลือกส่งแอปที่เชื่อมต่อและดำเนินการต่อ
  3. หากลบแพ็กเกจก่อนหน้าไม่ได้ ให้เพิ่ม 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 เวอร์ชันเดียวกับที่ส่งมา