Transactions API tidak akan digunakan lagi mulai 3 Mei 2023, sebelum penghentian Percakapan Percakapan pada 13 Juni 2023. Untuk mengetahui informasi selengkapnya, lihat Penghentian Action Percakapan.

Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat transaksi digital yang dapat dikonsumsi

Panduan ini menjelaskan cara menambahkan transaksi digital ke Action Percakapan, sehingga pengguna dapat membeli produk digital habis pakai Anda.

Istilah utama: Produk digital yang habis pakai adalah unit penyimpanan persediaan (SKU) yang dapat digunakan dan dibeli oleh pengguna lebih dari sekali, seperti jumlah mata uang dalam game untuk game Android. Produk digital ini berbeda dengan produk digital tidak habis pakai yang hanya dapat dibeli satu kali oleh pengguna.

Untuk informasi selengkapnya tentang produk sekali beli yang dapat dipakai, lihat dokumentasi Android tentang fitur khusus produk sekali beli.

Alur transaksi

Panduan ini menguraikan setiap langkah pengembangan saat terjadi dalam alur transaksi produk digital. Saat menangani transaksi untuk produk digital, Action Anda menggunakan alur berikut:

Menyiapkan klien API pembelian digital: Action Anda menggunakan API pembelian digital untuk berkomunikasi dengan inventaris Google Play dan bertransaksi. Sebelum Action Anda melakukan hal lain, Action tersebut akan membuat klien JWT dengan kunci layanan untuk berkomunikasi dengan API pembelian digital.
Mengumpulkan informasi: Action Anda mengumpulkan informasi dasar tentang pengguna dan inventaris Google Play untuk mempersiapkan transaksi.
1. Validasi persyaratan transaksi: Action Anda menggunakan helper persyaratan transaksi digital di awal alur pembelian untuk memastikan pengguna dapat bertransaksi.
2. Mengumpulkan inventaris yang tersedia: Action Anda memeriksa inventaris Google Play dan mengidentifikasi item yang saat ini tersedia untuk dibeli.
Buat pesanan: Action Anda menampilkan produk digital yang tersedia kepada pengguna sehingga mereka dapat memilih salah satu untuk dibeli.
Selesaikan pembelian: Action Anda menggunakan API pembelian digital untuk memulai pembelian dengan pilihan pengguna dari Google Play Store.
Menangani hasilnya: Action Anda menerima kode status untuk transaksi dan memberi tahu pengguna bahwa pembelian berhasil (atau melakukan langkah tambahan).
Buat pembelian dapat diulang: Action Anda menggunakan API pembelian digital untuk "memakai" item yang dibeli, sehingga item tersebut dapat dibeli kembali oleh pengguna tersebut.

Pembatasan dan panduan peninjauan

Kebijakan tambahan berlaku untuk Action dengan transaksi. Kami membutuhkan waktu beberapa minggu untuk meninjau Action yang menyertakan transaksi, jadi pertimbangkan waktu tersebut saat merencanakan jadwal rilis Anda. Untuk memudahkan proses peninjauan, pastikan Anda mematuhi kebijakan dan panduan untuk transaksi sebelum mengirimkan Action untuk ditinjau.

Tindakan yang menjual produk digital hanya dapat di-deploy di negara berikut:

Australia
Brasil
Kanada
Indonesia
Jepang
Meksiko
Rusia
Singapura
Thailand
Turkiye
Inggris Raya
Amerika Serikat

Prasyarat

Sebelum memasukkan transaksi digital ke dalam Action, Anda memerlukan prasyarat berikut:

Akun developer dan akun penjual di Google Play, untuk mengelola produk digital Anda di konsol Google Play.
Domain web yang terverifikasi di Google Search Console. Domain ini tidak perlu dikaitkan dengan situs yang diluncurkan secara publik, kami hanya perlu mereferensikan domain web Anda.
Aplikasi Android dengan izin com.android.vending.BILLING di konsol Google Play. Produk digital Anda akan menjadi “pembelian dalam aplikasi” yang terkait dengan aplikasi ini di konsol Google Play.

Anda juga perlu membuat rilis di konsol Play dengan aplikasi ini, tetapi jika tidak ingin rilis bersifat publik, Anda dapat membuat rilis alfa tertutup.

Jika Anda belum memiliki aplikasi Android, ikuti petunjuk Mengaitkan Aplikasi Android.
Satu atau beberapa produk terkelola di konsol Google Play, yang merupakan produk digital yang Anda jual dengan Action Anda. Perlu diperhatikan bahwa Anda tidak dapat membuat produk terkelola di konsol Play sebelum menyiapkan prasyarat aplikasi Android.

Jika Anda belum memiliki produk terkelola, ikuti petunjuk Membuat Produk Digital Anda.

Mengaitkan Aplikasi Android

Jika saat ini Anda belum memiliki aplikasi Android dengan izin penagihan di konsol Google Play, ikuti langkah-langkah berikut:

Di Android Studio atau Android IDE pilihan Anda, buat project baru. Pilih opsi dalam perintah penyiapan project untuk membuat aplikasi yang sangat dasar.
Beri nama paket untuk project, seperti com.mycompany.myapp. Jangan biarkan nama ini sebagai default, karena Anda tidak dapat mengupload paket yang menyertakan com.example ke konsol Play.
Buka file AndroidManifest.xml aplikasi Anda.

Tambahkan baris kode berikut di dalam elemen manifest:

<uses-permission android:name="com.android.vending.BILLING" />

File AndroidManifest.xml Anda akan terlihat seperti blok kode berikut:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.mycompany.myapp">
    <uses-permission android:name="com.android.vending.BILLING" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />
</manifest>

Build aplikasi Anda sebagai APK yang ditandatangani. Di Android Studio, ikuti langkah-langkah berikut:
1. Buka Build, Generate Signed Bundle / APK.
2. Klik Next.
3. Di bagian Key store path, klik Create new.
4. Isi setiap kolom, lalu klik OK. Catat Sandi penyimpanan kunci dan Sandi kunci, dan simpan di tempat yang aman karena Anda akan menggunakannya nanti.
5. Klik Next.
6. Pilih rilis.
7. Pilih V1 (Tanda Tangan JAR).
8. Klik Selesai.
9. Setelah beberapa detik, Android Studio akan membuat file app-release.apk. Temukan file ini untuk digunakan nanti.
Di konsol Google Play, buat aplikasi baru.
Buka Rilis aplikasi.
Di bagian Jalur tertutup, buka Kelola, lalu Alfa.
Klik tombol Buat Rilis.
Di bagian Izinkan Google mengelola dan melindungi kunci penandatanganan Anda, masukkan informasi kunci penandatanganan Anda.
Upload file APK Anda.
Klik Simpan.

Membuat Produk Digital Anda

Jika saat ini Anda tidak memiliki produk digital di konsol Play, ikuti langkah-langkah berikut:

Di konsol Google Play, buka Produk dalam aplikasi, lalu Produk terkelola. Jika Anda melihat peringatan, ikuti petunjuk sebelumnya untuk membuat aplikasi Android atau klik link untuk membuat profil penjual.
Klik Buat Produk terkelola.
Isi kolom untuk produk digital Anda. Catat ID Produk, yaitu cara Anda akan mereferensikan produk ini dari Action Anda.
Klik Simpan.
Ulangi langkah 2-4 untuk setiap produk yang ingin Anda jual.

Contoh barang habis pakai di konsol Google Play.

Menyiapkan project Action

Setelah produk digital disiapkan di konsol Google Play, Anda harus mengaktifkan transaksi digital dan mengaitkan project Action Anda dengan aplikasi Play.

Penyiapan

Untuk mengaktifkan transaksi produk digital di project Action Anda, ikuti langkah-langkah berikut:

Di Konsol Actions, buka project Anda atau buat project baru.
Buka Deploy, lalu Directory information.
Di bagian Informasi tambahan dan Transaksi, centang kotak Ya di bagian Apakah Action Anda menggunakan Digital Purchase API untuk melakukan transaksi produk digital.
Klik Simpan.

Membuat kunci API produk digital

Untuk mengirim permintaan ke API produk digital, Anda perlu mendownload kunci akun layanan JSON yang terkait dengan project konsol Actions Anda.

Untuk mengambil kunci akun layanan, ikuti langkah-langkah berikut:

Di konsol Actions, klik ikon tiga titik di sudut kanan atas, lalu Project settings.
Temukan Project ID Action Anda.
Klik link ini untuk mengganti "<project_id>" dengan ID project Anda: https://console.developers.google.com/apis/credentials?project=project_id
Di navigasi utama, buka Credentials.
Di halaman yang muncul, klik Create credentials, lalu Service account key.
Buka Service Account, lalu klik New Service Account.
Beri nama akun layanan seperti transaksi digital.
Klik Create.
Tetapkan Role ke Project > Owner.
Klik Continue.
Klik Buat Kunci.
Pilih jenis kunci JSON.
Klik Create key dan download kunci akun layanan JSON.

Simpan kunci akun layanan ini di tempat yang aman. Anda akan menggunakan kunci ini dalam fulfillment Anda guna membuat klien untuk API pembelian digital.

Menghubungkan ke inventaris Play

Untuk mengakses produk digital Anda dari project Action, kaitkan domain web dan aplikasi Anda dengan project Anda sebagai properti yang terhubung.

Untuk menghubungkan domain web dan aplikasi konsol Play ke project Action Anda, ikuti langkah-langkah berikut:

Di Konsol Actions, buka Deploy, lalu Brand verification.
Jika Anda belum menghubungkan properti, hubungkan situs terlebih dahulu:
1. Klik tombol properti web (</>).
2. Masukkan URL untuk domain web Anda, lalu klik Connect.
Google akan mengirimkan email yang berisi petunjuk lebih lanjut kepada individu yang memverifikasi untuk domain web tersebut di Google Search Console. Setelah penerima email ini mengikuti langkah-langkah tersebut, situs akan muncul di bagian Verifikasi brand.
Setelah memiliki setidaknya satu situs yang terhubung, lakukan langkah-langkah berikut untuk menghubungkan aplikasi Android Anda:
1. Di Konsol Actions, buka Deploy, lalu Brand verification.
2. Klik Hubungkan Aplikasi.
3. Di halaman yang muncul, ikuti petunjuk untuk memverifikasi domain web Anda di konsol Play. Pilih aplikasi Play yang berisi produk digital Anda, lalu masukkan URL domain web persis seperti yang ditampilkan di halaman Verifikasi merek.
  
  Google akan mengirimkan email verifikasi sekali lagi kepada pemilik domain yang terverifikasi. Setelah mereka menyetujui verifikasi, aplikasi Play Anda akan muncul di bagian Verifikasi merek.
  
  Catatan: Domain web Anda akan muncul di Konsol Play sebelum muncul di Konsol Actions. Mungkin perlu waktu beberapa hari hingga konsol Actions diupdate.
4. Aktifkan Akses pembelian Play.

Gambar yang menampilkan situs dan aplikasi yang terhubung ke project Action.

Membuat alur pembelian

Setelah project Action dan inventaris produk digital Anda siap, bangun alur pembelian barang digital di webhook fulfillment percakapan Anda.

1. Menyiapkan klien API pembelian digital

Di webhook fulfillment percakapan, buat klien JWT dengan kunci JSON akun layanan dan cakupan https://www.googleapis.com/auth/actions.purchases.digital.

Kode Node.js berikut membuat klien JWT untuk API pembelian digital:

  const serviceAccount = {'my-file.json'};
  const request = require('request');
  const {google} = require('googleapis');

  const jwtClient = new google.auth.JWT(
    serviceAccount.client_email, null, serviceAccount.private_key,
    ['https://www.googleapis.com/auth/actions.purchases.digital'],
    null
  );

2. Mengumpulkan informasi

Sebelum pengguna dapat melakukan pembelian, Action Anda mengumpulkan informasi tentang kemampuan pengguna untuk melakukan pembelian dan barang yang tersedia dari inventaris.

2. a. Memvalidasi persyaratan pembelian digital

Sebaiknya pastikan akun pengguna disiapkan untuk melakukan transaksi sebelum memberi mereka opsi untuk melakukan pembelian. Anda harus beralih ke scene DigitalPurchaseCheck, yang memeriksa apakah pengguna telah diverifikasi, bahwa mereka melakukan transaksi pada platform yang diizinkan (layar smart, smart speaker, atau Android), dan berada di lokalitas yang mendukung transaksi digital.

Untuk membuat scene pemeriksaan pembelian digital, ikuti langkah-langkah berikut:

Dari tab Scenes, tambahkan Scene baru dengan nama DigitalPurchaseCheck.
Di bagian Slot fill, klik + untuk menambahkan slot baru.
Di bagian Select type, pilih actions.type.DigitalPurchaseCheckResult sebagai jenis slot.
Di kolom nama slot, beri nama DigitalPurchaseCheck pada slot.
Aktifkan kotak centang Customize slot value writeback (diaktifkan secara default).
Klik Simpan.

Pemeriksaan pembelian digital akan memberikan salah satu hasil berikut:

Jika persyaratannya terpenuhi, parameter sesi akan ditetapkan dengan kondisi berhasil dan Anda dapat melanjutkan dengan mengizinkan pengguna untuk membeli produk digital.
Jika satu atau beberapa persyaratan tidak dapat dipenuhi, parameter sesi akan ditetapkan dengan kondisi kegagalan. Dalam hal ini, Anda harus mengalihkan percakapan dari pengalaman transaksional, atau mengakhiri percakapan.

Untuk menangani hasil pemeriksaan Pembelian Digital, ikuti langkah-langkah berikut:

Dari tab Scenes, pilih scene DigitalPurchaseCheck yang baru dibuat.
Pada bagian Kondisi, klik + untuk menambahkan kondisi baru.

Di kolom teks, masukkan sintaksis kondisi berikut untuk memeriksa kondisi keberhasilan:

scene.slots.status == "FINAL" && session.params.DigitalPurchaseCheck.resultType == "CAN_PURCHASE"

Arahkan kursor ke kondisi yang baru saja ditambahkan, lalu klik panah atas untuk menempatkannya sebelum if scene.slots.status == "FINAL".

Aktifkan Kirim perintah dan berikan perintah sederhana yang memberi tahu pengguna bahwa mereka siap melakukan transaksi:

candidates:
  - first_simple:
      variants:
        - speech: >-
            You are ready to purchase digital goods.

Di bagian Transition, pilih scene lain, yang memungkinkan pengguna melanjutkan percakapan dan melakukan transaksi.
Pilih kondisi else if scene.slots.status == "FINAL".
Aktifkan Kirim perintah dan berikan perintah sederhana yang memberi tahu pengguna bahwa mereka tidak dapat melakukan transaksi:
```
candidates:
  - first_simple:
      variants:
        - speech: Sorry you cannot perform a digital purchase.
```
Di bagian Transition, pilih End conversation untuk mengakhiri percakapan.

2. b. Mengumpulkan inventaris yang tersedia

Gunakan API pembelian digital untuk meminta inventaris Play Store yang saat ini tersedia, lalu gabungkan ke dalam array objek JSON untuk setiap produk. Anda mereferensikan array ini nanti untuk menunjukkan kepada pengguna opsi yang tersedia untuk dibeli.

Setiap produk digital Anda direpresentasikan sebagai SKU dalam format JSON. Kode Node.js berikut menguraikan format yang diharapkan untuk setiap SKU:

body = {
  skus: [
    skuId: {
      skuType: one of "SKU_TYPE_IN_APP" or "SKU_TYPE_SUBSCRIPTION"
      id: string,
      packageName: string
    }
    formattedPrice: string,
    title: string,
    description: string
  ]
}

Kirim permintaan POST ke endpoint https://actions.googleapis.com/v3/packages/{packageName}/skus:batchGet, dengan {packageName} sebagai nama paket aplikasi Anda di Konsol Google Play (misalnya, com.myapp.digitalgoods), dan format hasilnya ke dalam array objek SKU.

Untuk hanya mengambil produk digital tertentu dalam array yang dihasilkan, cantumkan ID produk untuk produk digital (seperti yang ditunjukkan di bawah setiap produk dalam aplikasi di Konsol Google Play) yang ingin Anda sediakan untuk dibeli di body.ids.

Kode Node.js berikut meminta daftar barang yang tersedia dari API pembelian digital dan memformat hasilnya sebagai array SKU:

return jwtClient.authorize((err, tokens) => {
    if (err) {
      throw new Error(`Auth error: ${err}`);
    }

    const packageName = 'com.example.projectname';

    request.post(`https://actions.googleapis.com/v3/packages/${packageName}/skus:batchGet`, {
      'auth': {
        'bearer': tokens.access_token,
      },
      'json': true,
      'body': {
        'conversationId': conv.session.id,
        'skuType': 'SKU_TYPE_IN_APP',
        // This request is filtered to only retrieve SKUs for the following product IDs
        'ids': ['consumable.1']
      },
    }, (err, httpResponse, body) => {
      if (err) {
        throw new Error(`API request error: ${err}`);
      }
      console.log(`${httpResponse.statusCode}: ${httpResponse.statusMessage}`);
      console.log(JSON.stringify(body));
    });
  });
});

3. Membuat pesanan

Untuk memulai pembelian digital pengguna, tunjukkan daftar produk digital Anda yang tersedia untuk dibeli. Anda dapat menggunakan berbagai jenis respons kaya untuk merepresentasikan stok Anda dan meminta pengguna untuk membuat pilihan.

Kode Node.js berikut membaca array inventaris objek SKU dan membuat respons daftar dengan satu item daftar untuk masing-masing:

const items = [];
const entries = [];
skus.forEach((sku) => {
   const key = `${sku.skuId.skuType},${sku.skuId.id}`
   items.push({
       key: key
   });
   entries.push({
       name: key,
       synonyms: [],
       display: {
           title: sku.title,
           description: `${sku.description} | ${sku.formattedPrice}`,
       }
   });
});

conv.session.typeOverrides = [{
   name: 'type_name',
   mode: 'TYPE_REPLACE',
   synonym: {
       entries: entries
   }
}];

conv.add(new List({
   title: 'List title',
   subtitle: 'List subtitle',
   items: items,
}));

Buat pembelian dari pilihan pengguna

Setelah pengguna memilih item, Anda dapat membuat pesanan. Untuk melakukannya, pada slot yang terkait dengan item yang dipilih, Anda dapat memanggil webhook untuk membuat pesanan. Dari fulfillment Anda, simpan data pesanan ke parameter sesi. Objek urutan digunakan di seluruh scene untuk sesi yang sama.

conv.session.params.purchase = {
  "@type": "type.googleapis.com/google.actions.transactions.v3.CompletePurchaseValueSpec",
  "skuId": {
    "skuType": "<SKU_TYPE_IN_APP>",
    "id": "<SKU_ID>",
    "packageName": "<PACKAGE_NAME>"
  },
  "developerPayload": ""
};

Di Action Builder, Anda dapat menggunakan editor JSON untuk mengonfigurasi slot dengan objek urutan di atas. Kedua implementasi menggunakan format yang sama untuk CompletePurchaseValueSpec, yang dapat Anda temukan di referensi payload webhook JSON.

4. Selesaikan pembelian

Setelah pengguna memilih item, Anda dapat menyelesaikan pembelian. Setelah mengisi slot yang terkait dengan item yang dipilih, Anda harus beralih ke scene yang melakukan pembelian penuh.

Buat Adegan Pembelian Lengkap

Dari tab Scenes, tambahkan scene baru dengan nama CompletePurchase.
Di bagian Slot fill, klik + untuk menambahkan slot baru.
Di bagian Pilih jenis, pilih actions.type.CompletePurchaseValue sebagai jenis slot.
Di kolom nama slot, beri nama CompletePurchase pada slot.
Aktifkan kotak centang Customize slot value writeback (diaktifkan secara default).
Di bagian Konfigurasi slot, pilih Use session parameter dari dropdown.
Di bagian Konfigurasi slot,masukkan nama parameter sesi yang digunakan untuk menyimpan urutan ke dalam kolom teks (yaitu $session.params.purchase).
Klik Simpan.

5. Menangani hasil

Slot dengan jenis actions.type.CompletePurchaseValue dapat memiliki hasil berikut:

PURCHASE_STATUS_OK: Pembelian berhasil. Transaksi selesai pada tahap ini, jadi keluar dari alur transaksi dan beralih kembali ke percakapan Anda.
PURCHASE_STATUS_ALREADY_OWNED: Transaksi gagal karena pengguna sudah memiliki item tersebut. Hindari error ini dengan memeriksa pembelian sebelumnya oleh pengguna dan menyesuaikan item yang ditampilkan agar tidak memiliki opsi untuk membeli kembali item yang sudah dimiliki.
PURCHASE_STATUS_ITEM_UNAVAILABLE: Transaksi gagal karena item yang diminta tidak tersedia. Hindari error ini dengan memeriksa SKU yang tersedia mendekati waktu pembelian.
PURCHASE_STATUS_ITEM_CHANGE_REQUESTED: Transaksi gagal karena pengguna memutuskan untuk membeli pembelian lain. Minta ulang dengan membuat pesanan Anda agar pengguna dapat segera membuat keputusan lain.
PURCHASE_STATUS_USER_CANCELLED: Transaksi gagal karena pengguna membatalkan alur pembelian. Karena pengguna keluar dari alur sebelum waktunya, tanyakan kepada pengguna apakah mereka ingin mencoba lagi transaksi atau keluar dari transaksi sepenuhnya.
PURCHASE_STATUS_ERROR: Transaksi gagal karena alasan yang tidak diketahui. Beri tahu pengguna bahwa transaksi gagal, dan tanyakan apakah mereka ingin mencoba lagi.
PURCHASE_STATUS_UNSPECIFIED: Transaksi gagal karena alasan yang tidak diketahui, sehingga status tidak diketahui. Tangani status error ini dengan memberi tahu pengguna bahwa transaksi gagal, dan tanyakan apakah mereka ingin mencoba lagi.

Anda harus menangani setiap hasil ini dari scene CompletePurchase.

Dari tab Scenes, pilih scene CompletePurchase yang baru dibuat.
Pada bagian Kondisi, klik + untuk menambahkan kondisi baru.

Di kolom teks, masukkan sintaksis kondisi berikut untuk memeriksa kondisi keberhasilan:

scene.slots.status == "FINAL" && session.params.CompletePurchase.purchaseStatus == "PURCHASE_STATUS_OK"

Arahkan kursor ke kondisi yang baru saja ditambahkan, lalu klik panah atas untuk menempatkannya sebelum if scene.slots.status == "FINAL".
Aktifkan Kirim perintah dan berikan perintah sederhana yang memberi tahu pengguna bahwa mereka siap melakukan transaksi:
```
candidates:
  - first_simple:
      variants:
        - speech: >-
            Your purchase was successful.
```
Di bagian Transition, pilih End conversation untuk mengakhiri percakapan.

Ulangi langkah-langkah di atas untuk setiap jenis hasil pembelian yang ingin Anda dukung.

6. Menjadikan pembelian dapat diulang

Setelah transaksi berhasil, kirim permintaan POST ke API pembelian digital untuk memakai item, sehingga pengguna dapat membelinya lagi. Kirim permintaan Anda ke endpoint https://actions.googleapis.com/v3/conversations/{sessionId}/entitlement:consume dengan ID sesi yang ditemukan di session.id.

Permintaan POST Anda juga harus menyertakan objek token pembelian yang terkait dengan pembelian pengguna, yang ditemukan dalam JSON permintaan pengguna di bagian packageEntitlements.entitlements.inAppDetails.inAppPurchaseData.purchaseToken.

Kode berikut mengirimkan permintaan consume ke API pembelian digital dan melaporkan apakah permintaan tersebut berhasil:

request.post(`https://actions.googleapis.com/v3/conversations/${conv.session.id}/entitlement:consume`, {
  'auth': {
    'bearer': tokens.access_token,
  },
  'json': true,
  'body': {
  // This purchase token is in both the purchase event and the user's entitlements
  // in their request JSON
    "purchaseToken": entitlement.purchaseToken
  },
  }, (err, httpResponse, body) => {
    if (err) {
     throw new Error(`API request error: ${err}`);
    }
  console.log(`${httpResponse.statusCode}: ${httpResponse.statusMessage}`);
  console.log(JSON.stringify(httpResponse));
  console.log(JSON.stringify(body));
  resolve(body);
});

// Make sure the consume request was successful. In production, don't notify the user; handle failures on the back end
return consumePromise.then(body => {
  const consumed = Object.keys(body).length === 0;
  if (consumed) {
    conv.add(`You successfully consumed ${id}`);
  } else {
    conv.add(`Failed to consume: ${id}`);
  }
});

Mencerminkan pembelian pengguna

Saat pengguna membuat kueri Action Anda, objek user JSON permintaan akan menyertakan daftar pembelian mereka. Periksa informasi ini dan ubah respons Action Anda berdasarkan konten yang telah dibayar pengguna.

Kode contoh berikut menunjukkan objek user permintaan yang menyertakan packageEntitlements pembelian dalam aplikasi sebelumnya yang mereka lakukan untuk paket com.digitalgoods.application:

{
  "handler": {
    "name": "handler_name"
  },
  "intent": {
    "name": "actions.intent.MAIN",
    "params": {},
    "query": ""
  },
  "scene": {
    "name": "SceneName",
    "slotFillingStatus": "UNSPECIFIED",
    "slots": {}
  },
  "session": {
    "id": "example_session_id",
    "params": {},
    "typeOverrides": []
  },
  "user": {
    "locale": "en-US",
    "params": {
      "verificationStatus": "VERIFIED"
      "packageEntitlements": [
        {
          "packageName": "com.digitalgoods.application",
          "entitlements": [
            {
              "sku": "non-consumable.1",
              "skuType": "SKU_TYPE_IN_APP"
            }
            {
              "sku": "consumable.2",
              "skuType": "SKU_TYPE_IN_APP"
            }
          ]
        },
        {
          "packageName": "com.digitalgoods.application",
          "entitlements": [
            {
              "sku": "annual.subscription",
              "skuType": "SKU_TYPE_SUBSCRIPTION",
              "inAppDetails": {
                "inAppPurchaseData": {
                  "autoRenewing": true,
                  "purchaseState": 0,
                  "productId": "annual.subscription",
                  "purchaseToken": "12345",
                  "developerPayload": "HSUSER_IW82",
                  "packageName": "com.digitalgoods.application",
                  "orderId": "GPA.233.2.32.3300783",
                  "purchaseTime": 1517385876421
                },
                "inAppDataSignature": "V+Q=="
              }
            }
          ]
        }
      ]
     }
   },
  "homeStructure": {
    "params": {}
  },
  "device": {
    "capabilities": [
      "SPEECH",
      "RICH_RESPONSE",
      "LONG_FORM_AUDIO"
    ]
  }
}

Menguji project Anda

Saat menguji project, Anda dapat mengaktifkan mode sandbox di Konsol Actions untuk menguji Action tanpa mengenakan biaya metode pembayaran. Untuk mengaktifkan mode sandbox, ikuti langkah-langkah berikut:

Di konsol Actions, klik Test di navigasi.
Klik Setelan.
Aktifkan opsi Development Sandbox.