Dijital abonelik işlemleri oluşturma

Bu kılavuzda, dijital abonelik işlemlerini Görüşmelerinize nasıl ekleyeceğiniz açıklanmıştır. Kullanıcıların aboneliklerinizi satın alabilmesi için işlem.

Anahtar terimler: Abonelik dijital ürün, abonelik gerektiren bir stok tutma birimidir (SKU). kullanıcıdan yinelenen bir ödeme alınmasını gerektiriyor (ör. online bir dergi). Bu Kullanıcının manuel olarak eklemesi gereken, tüketilebilir dijital maldan farklıdır. veya otomatik olarak satın alınan tüketilebilir olmayan bir dijital mal yalnızca bir kez satın alındı.

Dijital abonelikler hakkında daha fazla bilgi için belgeleri aboneliğe özgü özellikleri inceleyin.

İşlem akışı

Bu kılavuzda, dijital bir üründe gerçekleştiği şekliyle her bir geliştirme adımı özetlenmektedir her zaman daha iyidir. İşleminiz dijital ürünlerle ilgili işlemleri gerçekleştirdiğinde, şu akışı kullanır:

1. Digital purchase API istemcisi oluşturma: İşleminiz dijital satın alma işlemleri için satın alma işlemleri API'sini kullanarak Google Play envanterinizle iletişim kurabilir ve işlem yapabilirsiniz. İşleminiz başka herhangi bir şey yapmadan önce, dijital satın alma API'si ile iletişim kurmak için hizmet anahtarını kullanın.
2. Bilgi toplama: İşleminiz, bir işleme hazırlanmak için Google Play envanterinizin bir kopyasını sunar.
   1. İşlem şartlarını doğrulama: İşleminiz, satın alma akışının başında işlem gereklilikleri yardımcısına kullanıcının işlem yapabildiğinden emin olun.
   2. Kullanılabilir envanteri toplama: İşleminiz Google Play'i kontrol eder envanter ve şu anda hangi öğelerin satın alınabileceğini belirler.
3. Düzeni oluşturma: İşleminiz mevcut dijital ürünleri müşterilere sunar Böylece bir satın alma işlemi seçebiliyorlar.
4. Satın alma işlemini tamamlama: İşleminiz dijital satın alma işlemleri API'sini kullanarak Kullanıcının Google Play Store'da seçtiği bir satın alma işlemini başlatma.
5. Sonucu işleme: İşleminiz işlemi tamamlar ve kullanıcıya satın alma işleminin başarılı olduğunu (veya adımları).

Kısıtlamalar ve inceleme kuralları

İşlem içeren işlemler için ek politikalar geçerlidir. Yapmamız gereken birkaç İşlemleri içeren İşlemler'i incelemek üzere birkaç hafta bekleyin. Bu nedenle, yayın planınızı hazırlarsınız. İnceleme sürecini kolaylaştırmak için şununla: işlemlerle ilgili politikalar ve kurallar incelemenizi öneririz.

Dijital ürün satan işlemler yalnızca aşağıdaki ülkelerde dağıtılabilir:

• Avustralya
• Brezilya
• Kanada
• Endonezya
• Japonya
• Meksika
• Rusya
• Singapur
• Tayland
• Türkiye
• Birleşik Krallık
• Amerika Birleşik Devletleri

ziyaret edin.

Not: İnceleme süreci sırasında, izin verilmez. Bu kullanıcılar, işlemler İşlem inceleme süreci. İşleminiz tam olarak incelenip yayınlanana kadar herkese açık olacaktır.

Ön koşullar

Dijital işlemleri İşleminize dahil etmeden önce, şu ön koşulları sağlar:

• CEVAP geliştirici hesabı ve satıcı hesabı dijital ürünlerinizi yönetmek için Google Play'de Google Play Console.

• Gemini, Google Search Console'da doğrulanmış. Bu alan adının herkese açık bir web sitesiyle ilişkilendirilmiş olması gerekmez. tek yapmamız gereken web alan adınızı referans almak.

• com.android.vending.BILLING yüklü bir Android uygulaması izin Play Console'da bulabilirsiniz. Dijital ürünleriniz "uygulama içi satın almalar" olacak Google Play Console'da bu uygulamayla ilişkilendirilir.

  Bu uygulama ile Play Console'da da bir sürüm oluşturmanız gerekir, ancak yayının herkese açık olmasını istemiyorsanız kapalı alfa sürümü oluşturabilirsiniz. sürüm ekleyebilirsiniz.

  Henüz Android uygulamanız yoksa Bir Android uygulamasıyla ilişkilendirin.

• Şurada bir veya daha fazla abonelik: Google Play Console Bunlar İşleminizle sattığınız dijital ürünlerdir. Lütfen 'nı kurana kadar Play Console'da abonelik oluşturamazsınız Android uygulaması ön koşulu.

  Henüz bir aboneliğiniz yoksa Dijital Ürünler talimatlarınızı oluşturun.

Android Uygulaması İlişkilendirme

Şu anda Google Play Console'da şu adımları uygulayın:

1. Android Studio'da veya Android IDE'yi seçerseniz yeni bir proje oluşturun. Seçenekleri şurada belirleyin: çok temel bir uygulama oluşturmasını istiyor.
2. Projeye com.mycompany.myapp gibi bir paket adı verin. Şu özelliklere sahip paketleri yükleyemeyeceğiniz için bu adı varsayılan olarak bırakmayın: com.example öğelerini Play Console'a ekleyin.
3. Uygulamanızın AndroidManifest.xml dosyasını açın.

4. manifest öğesinin içine aşağıdaki kod satırını ekleyin:

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

   AndroidManifest.xml dosyanız aşağıdaki kod bloğu gibi görünmelidir:

   <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>
   

5. Uygulamanızı imzalı bir APK olarak oluşturun. Android Studio'da şu adımları uygulayın:

   1. Derleme, İmzalanmış Paket / APK Oluştur'a gidin.
   2. İleri'yi tıklayın.
   3. Anahtar deposu yolu bölümünde Yeni oluştur'u tıklayın.
   4. Her alanı doldurup Tamam'ı tıklayın. Anahtar deponuzu not edin. şifre ve Anahtar şifre gibi. Ayrıca, bunları güvenli bir yerde saklamanız gerekir. bunları daha sonra kullanacaksınız.
   5. İleri'yi tıklayın.
   6. Serbest bırak'ı seçin.
   7. V1 (JAR İmzası) seçeneğini belirleyin.
   8. Son'u tıklayın.
   9. Android Studio birkaç saniye sonra bir app-release.apk dosyası oluşturur. Daha sonra kullanmak üzere bu dosyayı bulun.

6. Google Play Console yeni bir uygulama oluşturabilirsiniz.

7. Uygulama sürümleri'ne gidin.

8. Kapalı kanallar bölümünde, Yönet'e ve ardından Alfa'ya gidin.

9. Sürüm Oluştur düğmesini tıklayın.

10. Google'ın imzalama anahtarınızı yönetmesine ve korumasına izin verin bölümünde imzalama anahtarınızı girin temel bilgiler.

11. APK dosyanızı yükleyin.

12. Kaydet'i tıklayın.

Dijital ürünlerinizi oluşturun

Şu anda Play Console'da dijital ürününüz yoksa şu adımları uygulayın: için şu adımları izleyin:

1. Google Play Console Uygulama içi ürünler'e, ardından Abonelikler'e gidin. Bir uyarı görürseniz Android uygulaması oluşturmak için önceki talimatları uygulayın veya bağlantıyı tıklayın satıcı profili oluşturun.
2. Abonelik oluştur'u tıklayın.
3. Dijital ürününüzle ilgili alanları doldurun. Ürün kimliğini not edin, İşleminizde bu ürüne nasıl atıfta bulunacaksınız?
4. Kaydet'i tıklayın.
5. Satmak istediğiniz her ürün için 2-4. adımları tekrarlayın.

Actions projenizi hazırlama

Dijital ürünlerinizi Google Play Console'da ayarladıktan sonra, ve Actions projenizi Play uygulamanızla ilişkilendirme.

Kurulum

Actions projenizde dijital ürün işlemlerini etkinleştirmek için şu adımları uygulayın: için şu adımları izleyin:

1. Actions Console'da projenizi açın veya yeni bir proje oluşturun.
2. Dağıtım'a, ardından Dizin bilgileri'ne gidin.
3. Ek bilgiler ve İşlemler bölümünde Evet kutusunu işaretleyin. İşlemleriniz, işlemleri gerçekleştirmek için Digital Purchase API'yi kullanıyor mu? sayısındaki artış.
4. Kaydet'i tıklayın.

Dijital ürünler API anahtarı oluşturma

Dijital ürünler API'sine istek göndermek için bir JSON hizmeti indirmeniz gerekir Actions konsolu projenizle ilişkili hesap anahtarınız.

Not: Sipariş karşılama hizmetinizi barındırmak için Google Cloud'u kullanıyorsanız hizmet hesabı anahtarı oluşturup indirin. Application Default Credentials (Uygulama Varsayılan Kimlik Bilgileri) ile ortam değişkeninin çalışma zamanında kullanılabilir olması gerekir.

Hizmet hesabı anahtarınızı almak için şu adımları uygulayın:

1. Actions Console'da sağ üst köşedeki üç nokta simgesini tıklayın. sonra Proje ayarları'nı tıklayın.
2. İşleminizin Proje Kimliğini bulun.
3. "<project_id>" kısmını değiştirerek bu bağlantıyı takip edin girin: https://console.developers.google.com/apis/credentials?project=project_id
4. Ana gezinme menüsünde Credentials'a (Kimlik bilgileri) gidin.
5. Görüntülenen sayfada Kimlik bilgileri oluştur'u, ardından Hizmet hesap anahtarı.
6. Hizmet Hesabı'na gidip Yeni Hizmet Hesabı'nı tıklayın.
7. Hizmet hesabına dijital işlemler gibi bir ad verin.
8. Oluştur'u tıklayın.
9. Rol'ü Proje > Sahibi.
10. Devam'ı tıklayın.
11. Anahtar Oluştur'u tıklayın.
12. JSON anahtar türünü seçin.
13. Anahtar oluştur'u tıklayın ve JSON hizmet hesabı anahtarını indirin.

Bu hizmet hesabı anahtarını güvenli bir yerde kaydedin. Bu anahtarı şurada kullanacaksınız: dijital satın alma işlemleri API'si için bir müşteri oluşturmak üzere istek karşılama.

Play envanterinize bağlanma

Bir Actions projesinden dijital ürünlerinize erişmek için web alanı ve uygulamanız arasında geçiş yapın. bağlı mülklerde görünmesidir.

Not: Doğrulama işlemi sırasında bağlantı adımlarının tamamlanması bir hafta kadar sürebilir. sahip olursunuz. Web siteniz veya uygulamanız bu sürenin sonunda bağlanmazsa destek ekibiyle iletişime geçin.

Play Console web alanınızı ve uygulamanızı Actions projenize bağlamak için aşağıdaki adımları uygulayın: şu adımları uygulayın:

1. Actions Console'da Dağıt'a, ardından Marka doğrulaması'na gidin.

2. Herhangi bir mülk bağlamadıysanız önce bir web sitesi bağlayın:

   1. Web mülkü (</>) düğmesini tıklayın.
   2. Web alanınızın URL'sini girip Bağlan'ı tıklayın.

   Google, talebi gönderen kişiye ek talimatların yer aldığı bir e-posta gönderir. o web alanı için doğrulanmış olmalıdır. Google Search Console. Bu e-postanın alıcısı bu adımları uyguladıktan sonra, web sitesi Marka doğrulaması bölümünde görünür.

3. En az bir bağlı web siteniz olduğunda aşağıdaki adımları uygulayarak Android uygulamanızı bağlayın:

   1. Actions Console'da Dağıt'a, ardından Marka doğrulaması'na gidin.
   2. Uygulama Bağlayın'ı tıklayın.

   3. Görüntülenen sayfada, web alan adına sahip olmanız gerekir. Şunu içeren Play uygulamasını seçin: ve web alan adı URL'sini tam olarak Marka doğrulama sayfası.

      Google bir kez daha, alan adı. Kullanıcı doğrulamayı onayladıktan sonra, Play uygulamanız Marka doğrulaması bölümünde görünür.

      Not: Web alanınız, görüntülenmeden önce Play Console'da görünür seçeneğini belirleyin. Actions konsolunun görünmesi birkaç gün sürebilir tıklayın.

   4. Play satın alma işlemlerine erişim'i etkinleştirin.

Satın alma akışınızı oluşturun

Actions projeniz ve dijital ürün envanteriniz hazırlandıktan sonra, işletmeniz için daha güçlü ürün satın alma akışınızın takibini yapın.

1. Dijital satın alma işlemleri API istemcisi kurma

Görüşme karşılama webhook'unuzda hizmetinizle bir JWT istemcisi oluşturun hesap JSON anahtarı ve https://www.googleapis.com/auth/actions.purchases.digital kapsamı.

Aşağıdaki Node.js kodu, dijital satın alma işlemleri API'si için bir JWT istemcisi oluşturur:

  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
  );

Not: Daha ayrıntılı yükleme adımlarını ve örnekleri Google API istemci kitaplığı GitHub sayfasına giderek daha fazla bilgi edinebilirsiniz.

2. Bilgi toplama

İşleminiz, kullanıcının satın alma işlemi yapabilmesi için öncelikle ve web sitenizde hangi ürünlerin mevcut olduğunu belirlemek için kullanıcının envanter.

2. a. İşlem şartlarını doğrulayın

Kullanıcının hesabının performans gösterecek şekilde ayarlandığından emin olmak işlemleri gerçekleştirmeleridir. Şunları yapmalısınız: kullanıcının doğrulanıp doğrulanmadığını kontrol eden bir DigitalPurchaseCheck sahnesine geçiş işlemi izin verilen bir yüzeyde (akıllı ekran, veya Android'deki gibi) ve dijital dünyanın çok iyi hissettiği bir desteklenir.

Dijital satın alma kontrolü sahnesi oluşturmak için aşağıdaki adımları izleyin:

1. Sahneler sekmesinden DigitalPurchaseCheck adlı yeni bir Sahne ekleyin.
2. Alan doldurma altında, yeni bir aralık eklemek için + simgesini tıklayın.
3. Tür seçin altında, şu şekilde actions.type.DigitalPurchaseCheckResult seçin: zaman aralığı türü.
4. Alan adı alanında, alana DigitalPurchaseCheck adını verin.
5. Alan değeri geri yazmayı özelleştir onay kutusunu etkinleştirin (varsayılan olarak etkindir).
6. Kaydet'i tıklayın.

Dijital satın alma kontrolü aşağıdaki sonuçlardan biriyle sonuçlanır:

• Koşullar karşılanırsa oturum parametresi başarıyla ayarlanır ve kullanıcının dijital ürünler satın almasına izin vererek devam edebilirsiniz.
• Koşullardan biri veya daha fazlası karşılanamazsa oturum parametresi bir hata koşuluyla ayarlanır. Bu durumda konuşmanın yönünü veya görüşmeyi sonlandırmanız gerekebilir.

Dijital Satın Alma kontrolü sonucunu işlemek için aşağıdaki adımları izleyin:

1. Sahneler sekmesinden, yeni oluşturduğunuz DigitalPurchaseCheck sahnesini seçin.
2. Koşul altında, yeni bir koşul eklemek için + simgesini tıklayın.

3. Metin alanına, başarı koşulu:

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

4. İmlecinizi yeni eklediğiniz koşulun üzerine getirin ve yukarı oku tıklayın if scene.slots.status == "FINAL" öncesine yerleştireceğiz.

5. İstemleri gönder'i etkinleştirin ve kullanıcıyı bilgilendiren basit bir istem sağlayın bir işlem yapmaya hazır olduğundan emin olun.

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

6. Transition bölümünde, kullanıcının devam etmesine izin veren başka bir sahne seçin ve işleme devam edebilirsiniz.

7. Koşulu else if scene.slots.status == "FINAL" seçin.

8. İstemleri gönder'i etkinleştirin ve kullanıcıyı bilgilendiren basit bir istem sağlayın işlem yapamazlarsa:

   candidates:
     - first_simple:
         variants:
           - speech: Sorry you cannot perform a digital purchase.
   

9. Görüşmeyi sonlandırmak için Geçiş bölümünde Görüşmeyi sonlandır'ı seçin.

2. b. Kullanılabilir envanter toplama

Şu anda kullanılabilir olan Play Store'unuzu istemek için dijital satın alma işlemleri API'sini kullanın daha sonra bunu her ürün için bir JSON nesneleri dizisinde derleyebilirsiniz. Daha sonra kullanıcıya hangi seçeneklerin mevcut olduğunu göstermek için bu diziye başvurursunuz satın alabilirsiniz.

Dijital ürünlerinizin her biri JSON biçiminde bir SKU olarak gösterilir. İlgili içeriği oluşturmak için kullanılan Aşağıdaki Node.js kodu, her SKU için beklenen biçimlendirmeyi belirtir:

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

Şuraya bir POST isteği gönderin: https://actions.googleapis.com/v3/packages/{packageName}/skus:batchGet. uç noktadır; burada {packageName}, uygulamanızın Google Play'deki paket adıdır Konsol (örneğin, com.myapp.digitalgoods) girin ve sonucu SKU nesneleri dizisidir.

Yalnızca elde edilen dizide belirli dijital ürünleri almak için ürünü listeleyin Dijital ürünlerin kimlikleri (Google Play'deki her uygulama içi ürünün altında gösterildiği gibi) Console) (body.ids) satın alabilirsiniz.

Aşağıdaki Node.js kodu, satın alma API'sini kullanır ve sonucu bir SKU dizisi olarak biçimlendirir:

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': ['annual.subscription']
      },
    }, (err, httpResponse, body) => {
      if (err) {
        throw new Error(`API request error: ${err}`);
      }
      console.log(`${httpResponse.statusCode}: ${httpResponse.statusMessage}`);
      console.log(JSON.stringify(body));
    });
  });
});

3. Siparişi oluşturma

Kullanıcının dijital satın alma işlemini başlatmak için dijital ürünlerinizin bir listesini sunun satın alınabilir. Birbirinden farklı türde zengin yanıt türlerini ve kullanıcıdan seçim yapmasını istemesidir.

İpucu: Satacak tek bir öğeniz varsa, satış yapan tek bir öğeyle etkileşimi basitleştirin basit bir yanıt yanıt olarak evet veya hayır verebilirsiniz.

Aşağıdaki Node.js kodu, SKU nesnelerinden oluşan bir envanter dizisini okur ve bir şunun için tek bir liste öğesi içeren yanıtı listele: her:

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,
}));

Kullanıcı seçiminden satın alma işlemi oluşturun

Kullanıcı bir öğe seçtiğinde siparişi oluşturabilirsiniz. Bunu yapmak için alakalı reklam öğesi arıyorsa webhook'unuza çağrı yaparak siparişi oluşturacaktır. Sipariş karşılamadaki sipariş verilerini bir oturuma kaydedin. parametresinden sonra bir değer girin. Sipariş nesnesi, aynı oturumdaki sahnelerde kullanılır.

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": ""
};

Actions Builder'da, bunun yerine alanı yapılandırmak için JSON düzenleyiciyi kullanabilirsiniz. yukarıdaki sipariş nesnesiyle. Her iki uygulama da CompletePurchaseValueSpec, bu politikayı şurada bulabilirsiniz: JSON webhook yük referansı.

4. Satın alma işlemini tamamla

Kullanıcı bir öğe seçtikten sonra satın alma işlemini tamamlayabilirsiniz. yuvaya yerleştirildikten sonra, bu öğe için uygun bir sahneye tam bir satın alma işlemi gerçekleştirir.

Dikkat: Bu adımı test etmek için Actions Console simülatörünü kullanmayın. Test amacıyla İşlemin dijital satın alma işlemleri, Android'de Google Asistan'ı kullanma işlemi yapmanızı öneririz.

Tam Satın Alma Sahnesi Oluşturma

1. Sahneler sekmesinden CompletePurchase adlı yeni bir sahne ekleyin.
2. Alan doldurma altında, yeni bir aralık eklemek için + simgesini tıklayın.
3. Tür seçin altında actions.type.CompletePurchaseValue zaman aralığı türü.
4. Alan adı alanında, alana CompletePurchase adını verin.
5. Alan değeri geri yazmayı özelleştir onay kutusunu etkinleştirin (varsayılan olarak etkindir).
6. Alanı yapılandır'ın altındaki açılır listeden Use session parameter'yi seçin.
7. Alanı yapılandır altında,şu işlemle kullanılan oturum parametresinin adını girin: siparişi metin alanına ($session.params.purchase) kaydedin.
8. Kaydet'i tıklayın.

5. Sonucu işleme

actions.type.CompletePurchaseValue türüne sahip bir alan aşağıdaki gibi olabilir sonuç:

• PURCHASE_STATUS_OK: Satın alma işlemi başarılı oldu. İşlem Bu nedenle, işlem akışından çıkıp tekrar yardımcı olabilir.
• PURCHASE_STATUS_ALREADY_OWNED: Kullanıcı, bu öğenin zaten sahibi olduğu anlamına gelir. Bu hatadan kaçınmak için, kullanıcının ve gösterilen ürünleri, çok daha fazla müşteriye sahip oldukları ürünleri tekrar satın almalarına yardımcı olur.
• PURCHASE_STATUS_ITEM_UNAVAILABLE: İşlem şu nedenle başarısız oldu: istenen öğe mevcut değil. Mevcut öğeleri kontrol ederek bu hatadan Satın alma zamanına yakın SKU'lar.
• PURCHASE_STATUS_ITEM_CHANGE_REQUESTED: İşlem şu nedenle başarısız oldu: karar veren bir kullanıcı olduğunu varsayalım. Sipariş oluşturma sürecinizle ilgili yeniden istem Böylece kullanıcı hemen başka bir karar verebilir.
• PURCHASE_STATUS_USER_CANCELLED: Kullanıcı, satın alma akışını iptal etti. Kullanıcı akıştan erken çıktığı için kullanıcıya işlemi yeniden denemek mi yoksa işlemden çıkmak mı istediğini sorun. Hepsini.
• PURCHASE_STATUS_ERROR: İşlem bilinmeyen bir nedenden dolayı başarısız oldu. Kullanıcıya işlemin başarısız olduğunu bildirin ve tekrar denemek isteyip istemediğini sorun.
• PURCHASE_STATUS_UNSPECIFIED: İşlem bilinmeyen bir nedenden dolayı başarısız oldu. bilinmeyen bir duruma neden olur. Bu hata durumunu, kullanıcıya işlemin başarısız olduğunu anlar ve tekrar denemek isteyip istemediklerini sorun.

CompletePurchase sahnenizden bu sonuçların her birini işlemeniz gerekir.

1. Sahneler sekmesinden, yeni oluşturduğunuz CompletePurchase sahnesini seçin.
2. Koşul altında, yeni bir koşul eklemek için + simgesini tıklayın.

3. Metin alanına, başarı koşulu:

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

4. İmlecinizi yeni eklediğiniz koşulun üzerine getirin ve yukarı oku tıklayın if scene.slots.status == "FINAL" öncesine yerleştireceğiz.

5. İstemleri gönder'i etkinleştirin ve kullanıcıyı bilgilendiren basit bir istem sağlayın bir işlem yapmaya hazır olduğundan emin olun.

   candidates:
     - first_simple:
         variants:
           - speech: >-
               Your purchase was successful.
   

6. Görüşmeyi sonlandırmak için Geçiş bölümünde Görüşmeyi sonlandır'ı seçin.

Desteklemek istediğiniz her satın alma sonucu türü için yukarıdaki adımları tekrarlayın.

Kullanıcının satın alma işlemlerini yansıtın

Bir kullanıcı İşleminizi sorguladığında, isteğin JSON'un user nesnesi bir ve satın alma işlemi listesidir. Bu bilgileri kontrol edin ve kullanıcının ödeme yaptığı içeriğe göre yanıt vermesi gerekir.

Not: JSON isteği yalnızca kullanıcının yaptığı satın alma işlemlerini içerir. Google Play Store'a veya İşleminize ait bir uygulama. Yapılan satın alma işlemlerine erişmek için Android dışı platformlarda ise kullanıcıdan hesaplarını bağlamasını isteyin. Ardından, satın alma işlemlerini belirlemek için kullanıcınızın hesap geçmişine başvurabilirsiniz. yardımcı oluyor.

Aşağıdaki örnek kod, bir isteğin aşağıdakileri içeren user nesnesini göstermektedir: Daha önce yaptıkları uygulama içi satın almaların packageEntitlements kadarı com.digitalgoods.application paketi:

{
  "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"
    ]
  }
}

Projenizi test etme

Projenizi test ederken Actions konsolunda korumalı alan modunu etkinleştirebilirsiniz ödeme yönteminden ödeme almadan İşleminizi test edin. Korumalı alan modunu etkinleştirmek için şu adımları uygulayın:

1. Actions konsolundaki gezinme bölümünde Test'i tıklayın.
2. Ayarlar'ı tıklayın.
3. Geliştirme Korumalı Alanı seçeneğini etkinleştirin.