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

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

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

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

ข้อควรระวัง: เนื่องจากข้อจำกัดด้านกฎระเบียบ แอปที่เข้าร่วมโปรแกรมออกแบบเพื่อครอบครัว ไม่อนุญาตให้โปรแกรมสำหรับครอบครัว (DFF) มีการดำเนินการของแอป หากคุณส่ง การดำเนินการของแอปเพื่อการตรวจสอบแอปที่อยู่ในโปรแกรม DFF ไม่ได้

ข้อกำหนด

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

• คุณต้องมีบัญชี Google ที่มีสิทธิ์เข้าถึง Google Play Console
• แอปของคุณต้องเผยแพร่ใน Google Play Store เนื่องจาก App Actions พร้อมให้บริการสำหรับแอปที่เผยแพร่ใน 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 ไปใช้

สำคัญ: ข้อกำหนดในการทำให้ App Actions ใช้งานได้คือแอปที่ ที่มีฟังก์ชันการค้นหาต้องใช้ actions.intent.GET_THING BII เพื่อให้ผู้ใช้ค้นหาเนื้อหาในแอปได้ด้วย คำสั่งเสียงที่ใช้กันโดยทั่วไป เช่น "Ok Google ค้นหารองเท้าวิ่งใน แอปตัวอย่าง"

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

หมายเหตุ: ในกรณีที่ไม่มี 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.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

หมายเหตุ: ต้องมีไลบรารี Jetpack androidx.core:core:1.6.0 (หรือใหม่กว่า) ใน Android เพื่อหลีกเลี่ยงข้อผิดพลาดในการคอมไพล์เมื่อกำหนดความสามารถของการดำเนินการของแอปใน shortcuts.xml โปรดดูรายละเอียดที่หัวข้อเริ่มต้นใช้งาน Android Jetpack

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

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

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

เคล็ดลับ: เมื่อแอปมีหลาย Intent ที่ตอบสนองความต้องการเดียว 2. Assistant จะพยายามแก้ไขตามลำดับที่ปรากฏใน องค์ประกอบ capability

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

ใช้ Intent ในตัว GET_THING

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

ในไฟล์ 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 เพื่อทดสอบว่า App Actions ทํางานกับแอปของคุณหรือไม่ ปลั๊กอินจะสร้างตัวอย่าง App Actions ใน Assistant สําหรับบัญชี Google ของคุณ การใช้เครื่องมือทดสอบจะช่วยให้คุณสามารถทดสอบ การดำเนินการให้สมบูรณ์ในอุปกรณ์ทดสอบหรือโปรแกรมจำลองโดยให้ BII พร้อมอินพุต พารามิเตอร์ที่คุณคาดว่าจะได้รับจากผู้ใช้

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

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

หมายเหตุ: เครื่องมือทดสอบการดำเนินการของแอปรองรับเฉพาะการทดสอบ BII ใน en-US เว้นแต่จะมีตัวอย่างการค้นหาสำหรับภาษาอื่นๆ ในภาษา ข้อมูลอ้างอิง Intent ในตัวที่เกี่ยวข้อง

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

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

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

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

หมายเหตุ: ผู้ใช้จะใช้งาน App Actions ในรุ่นของแทร็กการทดสอบแบบเปิดไม่ได้จนกว่าการดำเนินการจะได้รับการตรวจสอบและอนุมัติ ดูข้อมูลเพิ่มเติมได้ที่ส่วนถัดไป

ขอรับการตรวจสอบและใช้งาน App Actions

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

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

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

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

   

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

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

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

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

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

หมายเหตุ: ลิงก์ในรายละเอียดอาจอิงตาม URL ของ App Link, URL ตาม Intent หรือรูปแบบที่กำหนดเอง เช่น myapp://do.thing/param=value

หากต้องการทดสอบว่าเข้าถึงกิจกรรมได้และสามารถทริกเกอร์โดยใช้การดําเนินการของแอปโดยใช้ 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) และ/หรือพารามิเตอร์ของการดำเนินการของแอปต้องนำผู้ใช้ไปยัง การดำเนินการที่เกี่ยวข้องและมีเจตนาผู้ใช้ ซึ่งอาจรวมถึงเนื้อหาในแอป เนื้อหาเว็บไซต์ หรือข้อมูลที่แสดงในชิ้นส่วนหรือวิดเจ็ตตราบใดที่ ประสบการณ์ของผู้ใช้เป็นไปตามเป้าหมาย

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

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

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

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

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

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

---