สร้างการดําเนินการของแอป

การดำเนินการของแอปช่วยให้ผู้ใช้เปิดฟังก์ชันในแอป Android ของคุณได้ด้วยการถาม Google Assistant หรือใช้แป้นพิมพ์ลัดของ Android ที่ Assistant แนะนำ เหล่านี้ เป็นขั้นตอนหลักในการขยายแอป Android ด้วยการดำเนินการของแอป

1. ระบุฟังก์ชันการทำงานในแอปที่จะทริกเกอร์และการจับคู่ Intent ในตัว (BII)
2. ระบุรายละเอียดการจำหน่ายสำหรับ BII
3. พุชทางลัดสำหรับการดำเนินการของแอปไปยัง Assistant
4. แสดงตัวอย่างการดำเนินการของแอปในอุปกรณ์ทดสอบ
5. สร้างรุ่นทดสอบของแอป
6. ขอรับการตรวจสอบและการทำให้การดำเนินการของแอปใช้งานได้

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

ข้อกำหนด

ก่อนจะเริ่มพัฒนาการดำเนินการของแอป โปรดตรวจสอบว่าคุณและแอปเป็นไปตาม ข้อกำหนดต่อไปนี้

• คุณต้องมีบัญชี Google ที่มีสิทธิ์เข้าถึง Google Play Console
• คุณต้องเผยแพร่แอปไปยัง Google Play Store เนื่องจากการดำเนินการของแอป ใช้ได้กับแอปที่เผยแพร่ที่นั่นเท่านั้น นอกจากนี้ อย่าลืมตรวจสอบว่าแอป ไม่ได้มีไว้เพื่อใช้ในโปรไฟล์งาน เนื่องจากไม่รองรับการดำเนินการของแอป โดย Managed Google Play
• คุณต้องมีอุปกรณ์จริงหรืออุปกรณ์เสมือนเพื่อทดสอบการดำเนินการของแอป
• คุณต้องมี Android Studio เวอร์ชันล่าสุด
• คุณต้องใช้บัญชี Google เดียวกันในการลงชื่อเข้าใช้ Android Studio, แอป Google ในอุปกรณ์ทดสอบ และ Google Play Console
• คุณต้องตั้งค่า Assistant ในอุปกรณ์ทดสอบและทดสอบโดยดำเนินการ แตะและ กดปุ่มหน้าแรกค้างไว้

จับคู่ Intent ในตัวกับฟังก์ชันการทำงานของแอป

ระบุฟังก์ชันในแอป Android ที่ผู้ใช้อาจต้องการใช้ เพื่อข้ามไปยังด้วยคำขอที่พูด และตรวจสอบ การอ้างอิง Intent ในตัวเพื่อค้นหา BII ที่เหมาะสม สำหรับ Use Case ของคุณ โมเดล BI จะจำลองการค้นหาของผู้ใช้สำหรับงานที่ต้องการ ทำงาน ดังนั้นให้มองหา BII ที่ตรงกับฟังก์ชันหลักและผู้ใช้ ที่เพิ่มขึ้นในแอปของคุณ

มี BII ทั่วไปที่แอป Android เกือบทุกแอปสามารถใช้ เช่น การขยายการใช้งาน การค้นหาในแอปไปยัง Assistant ด้วย actions.intent.GET_THING BII หรือการให้ผู้ใช้เปิดตัวคุณลักษณะที่เจาะจงของแอปด้วยเสียงของตนโดย นำ actions.intent.OPEN_APP_FEATURE BII ไปใช้

นอกจากนี้ ยังมี BII ที่เปิดใช้กรณีการใช้งานประเภทธุรกิจหรือเฉพาะหมวดหมู่ด้วย สำหรับ เช่น แอปสั่งอาหารอาจใช้ actions.intent.ORDER_MENU_ITEM BII.

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

การดำเนินการของแอปทำงานโดยเริ่มใช้ Intent ของ Android จากแอป Assistant ผู้ใช้ไปยังเนื้อหาที่เจาะจงในแอปได้โดยตรง คุณสามารถกำหนด Intent เพื่อ เปิดกิจกรรมอย่างชัดแจ้งด้วยการระบุ targetClass และ targetPackage ช่อง หากแอปใช้ Deep Link ของ Android อยู่แล้ว URL คุณจะมีตัวเลือกในการกำหนดค่า Intent ที่จะใช้ Deep Link การดำเนินการตามคำสั่งซื้อ โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อทดสอบกิจกรรมของคุณแบบเจาะลึก ลิงก์

ระบุรายละเอียดการดำเนินการตามคำสั่งซื้อสำหรับ Intent ในตัว

การสร้างการดำเนินการของแอปส่วนใหญ่คือการประกาศความสามารถใน ไฟล์แหล่งข้อมูล shortcuts.xml ของแอป Android ที่คุณ ระบุ BII ที่คุณเลือกและการดำเนินการตามคำสั่งซื้อที่เกี่ยวข้อง A BII เป็นโมเดล ผู้ใช้ค้นหางาน และความตั้งใจในการดำเนินการเพื่อให้ Assistant ทราบ ข้อมูลเกี่ยวกับวิธีการทำงาน

ในไฟล์ shortcuts.xml BII จะแสดงเป็น <capability> และ Fulfillment แต่ละรายการจะแสดงเป็นองค์ประกอบ <intent> ดังนี้

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="menuItem.name"
                android:key="query">
            </parameter>
        </intent>
    </capability>

สำหรับ BII ส่วนใหญ่ คุณจะดึงพารามิเตอร์ Intent ออกจากคำค้นหาของผู้ใช้ อิงจากเอนทิตีของ schema.org จากนั้นแอปของคุณจะใช้ BII เพื่อนำผู้ใช้ไปยังความสามารถที่เลือก ตัวอย่างเช่น พารามิเตอร์ ก่อนหน้า โค้ดแมปพารามิเตอร์ menuItem.name BII กับ query Android intent พารามิเตอร์

หากคุณดำเนินการต่างๆ โดยใช้ Deep Link ให้ใช้ช่อง urlTemplate เพื่อกำหนด URL ของ Deep Link ที่ Assistant จะสร้างขึ้นมา

<shortcuts>
    <capability android:name="actions.intent.ORDER_MENU_ITEM">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myfoodapp://browse{?query}" />
            <parameter android:name="menuItem.name"
                android:key="query"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

สำหรับรายละเอียดสำคัญเกี่ยวกับการเพิ่มการดำเนินการของแอปลงในไฟล์ shortcuts.xml โปรดดูที่สร้าง shortcuts.xml และหน้าดังกล่าว อธิบายวิธีระบุค่าพารามิเตอร์ที่แอปคาดหวัง

ใช้ Intent ในตัว GET_THING

หากแอปมีฟังก์ชันการค้นหา คุณจะต้องติดตั้งใช้งาน actions.intent.GET_THING BII สำหรับฟังก์ชันนั้น จากนั้น Assistant ก็จะส่งต่อได้ ผู้ใช้ไปยังฟังก์ชันการค้นหาของแอปเพื่อดูผลการค้นหาในแอปเมื่อผู้ใช้ทำการค้นหา เช่น "Ok Google ค้นหา Example Thing ในแอป Example"

ในไฟล์ shortcuts.xml ให้ใช้ <capability> สำหรับ actions.intent.GET_THING BII ขณะที่คุณ ใช้ BII อื่นๆ คุณสามารถใช้การดำเนินการตามคำสั่งซื้อหลายรายการสำหรับ GET_THING ตราบใดที่คุณระบุ Fulfillment อย่างน้อย 1 รายการที่ส่งจากผู้ใช้ ไปยังฟังก์ชันการค้นหาของแอป

นี่คือตัวอย่างของการเพิ่ม actions.intent.GET_THING BII ใน shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

ในการค้นหา Activity ให้แยกคำค้นหาจากข้อมูลเพิ่มเติมของ intent และส่งไปยังฟังก์ชันการค้นหาของแอป ในโค้ดก่อนหน้านี้ พารามิเตอร์ คำค้นหาที่ส่งผ่านเป็นคีย์ query แมปกับ"thing.name" พารามิเตอร์ BII จากนั้นทำการค้นหาด้วยข้อความค้นหาและแสดงผลลัพธ์ใน อินเทอร์เฟซผู้ใช้

ไม่บังคับ: พุชทางลัดสำหรับการดำเนินการของแอปไปยัง Assistant

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

หากต้องการพุชทางลัดแบบไดนามิกไปยัง Assistant ให้ใช้การผสานรวมทางลัดของ Google ไลบรารี ไลบรารี Jetpack นี้ทำให้ Assistant สามารถใช้แป้นพิมพ์ลัดและ แนะนำผู้ใช้ในเวลาที่เหมาะสม

โปรดดูรายละเอียดเพิ่มเติมได้ที่พุชทางลัดแบบไดนามิกไปยัง Assistant

ดูตัวอย่างการดำเนินการของแอป

ระหว่างการพัฒนาและการทดสอบ ให้ใช้ ปลั๊กอิน Google Assistant สำหรับ Android Studio เพื่อทดสอบ การดำเนินการของแอปใช้ได้กับแอปของคุณ ปลั๊กอินจะสร้างตัวอย่างการดำเนินการของแอป ใน Assistant สำหรับบัญชี Google ของคุณ การใช้เครื่องมือทดสอบจะช่วยให้คุณสามารถทดสอบ การดำเนินการให้สมบูรณ์ในอุปกรณ์ทดสอบหรือโปรแกรมจำลองโดยให้ BII พร้อมอินพุต พารามิเตอร์ที่คุณคาดว่าจะได้รับจากผู้ใช้

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

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

สร้างรุ่นทดสอบ

เมื่อพร้อมทดสอบการดำเนินการของแอปกับผู้ทดสอบเพิ่มเติมแล้ว สร้างรุ่นการทดสอบภายในหรือแบบปิดของแอป โดยค่าเริ่มต้น ข้อมูลภายในและ ผู้ทดสอบรุ่นปิดสามารถเข้าถึงการดำเนินการของแอป ตรวจสอบและอนุมัติแล้ว

หากต้องการให้สิทธิ์การทดสอบในการเข้าถึงการดำเนินการของแอปทั้งหมด รวมถึงการดำเนินการที่ไม่ได้รับอนุมัติ แจ้งให้ผู้ทดสอบเข้าร่วม โปรแกรมการพัฒนาการดำเนินการของแอป Google Group สมาชิกของ กลุ่มมีสิทธิ์เข้าถึงการดำเนินการของแอปทั้งหมดในแบบปิดและ รุ่นทดสอบภายในโดยไม่ต้องสร้างตัวอย่างโดยใช้ เครื่องมือทดสอบการดำเนินการของแอป ระบบอาจใช้เวลาถึง 3 ชั่วโมงหลังจากเข้าร่วมกลุ่ม เพื่อให้เข้าถึงได้

ขอรับการตรวจสอบและการทำให้การดำเนินการของแอปใช้งานได้

การดำเนินการของแอปไม่พร้อมใช้งานสำหรับผู้ใช้แอปที่เผยแพร่หรือการทดสอบแบบเปิด ออกจนกว่าจะได้รับการตรวจสอบและอนุมัติ การตรวจสอบการดำเนินการของแอป ส่งผลต่อการตรวจสอบแอป Android และสถานะการติดตั้งใช้งานใน Google Play แม้ว่า การส่งแอปของคุณได้รับอนุมัติและเผยแพร่ไปยัง Play Store แล้ว shortcuts.xml อาจอยู่ระหว่างตรวจสอบโดย Google การดำเนินการของแอปใช้ไม่ได้กับ ผู้ใช้ปลายทางจนกว่าการตรวจสอบนั้นจะได้รับการอนุมัติด้วย

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

หากต้องการส่งการดำเนินการของแอปเข้ารับการตรวจสอบ ให้ทำดังนี้

1. ยอมรับข้อกำหนดในการให้บริการของการดำเนินการของแอปใน Google Play Console (การตั้งค่าขั้นสูง > การดำเนินการของแอป):

   

2. อัปโหลดแอปของคุณ ซึ่งมี shortcuts.xml ไปยัง Google Play Console สำหรับการเผยแพร่ตามปกติ

3. หลังจากอัปโหลดแอปไปยัง Play Console แล้ว Google จะติดต่อคุณที่ อีเมลในบัญชี Play Console ของคุณพร้อมข้อมูลเพิ่มเติมเกี่ยวกับสถานะ ของแอปของคุณ การตรวจสอบการดำเนินการ หรือจะติดต่อทีมสนับสนุนนักพัฒนาซอฟต์แวร์ของ Assistant ก็ได้ พร้อมคำถามเกี่ยวกับสถานะการตรวจสอบการดำเนินการของแอป อยู่ในรายชื่อติดต่อ ระบุรหัสแพ็กเกจแอป แล้วเลือกการตรวจสอบการดำเนินการของแอปใน ช่องการเลือกเราช่วยอะไรคุณได้บ้าง

ไม่บังคับ: ทดสอบ Deep Link ของกิจกรรม

ในการใช้ Deep Link เพื่อเปิด Activity โดยใช้การดำเนินการของแอป Activity ต้องตั้งค่าด้วย URL ของ Deep Link และมีตัวกรอง Intent ที่เกี่ยวข้องใน ไฟล์ Manifest ของแอป Android

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

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

เช่น

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

หากกิจกรรมเปิดขึ้นไม่ถูกต้องด้วยคำสั่ง adb ให้ตรวจสอบสิ่งต่อไปนี้

• กิจกรรมในไฟล์ Manifest ของแอปมี android:exported=true เพื่อให้สามารถ เปิดตัวด้วย Intent จาก Google Assistant
• หากใช้ URL ของลิงก์แอป ให้ทำตามขั้นตอนทั้งหมดใน การจัดการ Android App Link

นโยบายการดำเนินการของแอป

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

• นำผู้ใช้ไปยังเนื้อหาสำหรับจุดประสงค์ของผู้ใช้

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

  เช่น การติดตั้งใช้งาน ORDER_MENU_ITEM BII จะช่วยให้ผู้ใช้ เริ่มสั่งซื้อรายการในเมนูหรือประเภทอาหารที่ระบุ มีเพียง ข้อยกเว้นสําหรับนโยบายนี้ก็คือเมื่อ OPEN_APP_FEATURE BII นําผู้ใช้ ลงในหน้าจอหลักของแอป

• นำผู้ใช้ไปยังเนื้อหาเว็บที่เกี่ยวข้อง

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

  เช่น การเปลี่ยนเส้นทางผู้ใช้ที่ทริกเกอร์ GET_RESERVATION BII ของคุณให้กับ google.com/travel ซึ่งไม่ใช่ แบรนด์ exampledomain.com ของแอปคุณเป็นการละเมิด อีกตัวอย่างของ การละเมิดเป็นการเปลี่ยนเส้นทางผู้ใช้ที่ทริกเกอร์ GET_CALL_HISTORY BII ไปยัง exampledomain.com/payment และกำหนดให้ผู้ใช้ทำการซื้อ

• ใช้ BII ของการดำเนินการของแอปที่เกี่ยวข้อง

  BII ที่นำมาใช้จะต้องเกี่ยวข้องกับเนื้อหาของแอปโดยตรง

  ตัวอย่างเช่น หากแอปของคุณอยู่ในหมวดหมู่การสื่อสารของ Play Store ไม่ใช้ ORDER_MENU_ITEM BII ซึ่งเป็น แนะนำสำหรับแอปพลิเคชันในหมวดหมู่อาหารและเครื่องดื่ม

• ใช้ความตั้งใจที่กำหนดเองที่เกี่ยวข้อง

  คำค้นหาที่กำหนดไว้สำหรับความตั้งใจที่กำหนดเองเกี่ยวข้องกับเนื้อหาของแอปและ ตัวอย่างการละเมิดที่อาจเกิดขึ้น นโยบายกำลังสร้าง Intent custom.action.intent.GET_RECIPE ที่มี รูปแบบการค้นหาที่เชื่อมโยง "ขอดูสูตรเบอร์ริโตหน่อย" สำหรับแอปใน หมวดหมู่การขนส่งใน Play Store