REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

Jenis ini mewakili objek SubscriptionPurchaseV2 di layanan androidpublisher.

string

Kode negara/wilayah penagihan ISO 3166-1 alpha-2 pengguna pada saat langganan diberikan.

object (SubscriptionPurchaseLineItem)

Info tingkat item untuk pembelian langganan. Item dalam pembelian yang sama harus berupa paket AutoRenewingPlan atau semua dengan PrabayarPlan.

string (Timestamp format)

Waktu saat langganan diberikan. Tidak ditetapkan untuk langganan yang tertunda (langganan telah dibuat, tetapi menunggu pembayaran saat pendaftaran).

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

enum (SubscriptionState)

Status langganan saat ini.

string

ID pesanan dari pesanan terbaru yang terkait dengan pembelian langganan. Untuk langganan Perpanjangan Otomatis, ini adalah id pesanan pesanan pendaftaran jika belum diperpanjang, atau id pesanan berulang terakhir (pesanan berhasil, tertunda, atau ditolak). Untuk langganan prabayar, ID pesanan ini terkait dengan token pembelian yang dikueri.

string

Token pembelian langganan lama jika langganan ini adalah salah satu dari yang berikut: * Pendaftaran ulang langganan yang dibatalkan tetapi tidak lama * Mengupgrade/mendowngrade dari langganan sebelumnya. * Konversi langganan dari prabayar ke perpanjangan otomatis. * Mengonversi dari langganan yang diperpanjang otomatis ke prabayar. * Menambah saldo langganan prabayar.

object (PausedStateContext)

Konteks tambahan seputar langganan yang dijeda. Hanya ada jika langganan saat ini memiliki subscriptionState SUBSCRIPTION_ unit_PAUSED.

object (CanceledStateContext)

Konteks tambahan seputar langganan yang dibatalkan. Hanya ada jika langganan saat ini memiliki subscriptionState SUBSCRIPTION_STATE_CANCELED atau SUBSCRIPTION_was_EXPIRED.

object (TestPurchase)

Hanya ada jika pembelian langganan ini adalah pembelian percobaan.

enum (AcknowledgementState)

Status konfirmasi langganan.

object (ExternalAccountIdentifiers)

ID akun pengguna di layanan pihak ketiga.

object (SubscribeWithGoogleInfo)

Profil pengguna yang terkait dengan pembelian yang dilakukan menggunakan 'Berlangganan dengan Google'.

{
  "autoResumeTime": string
}

string (Timestamp format)

Waktu saat langganan akan dilanjutkan secara otomatis.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

Langganan dibatalkan oleh pengguna.

object (SystemInitiatedCancellation)

Langganan dibatalkan oleh sistem, misalnya karena masalah penagihan.

object (DeveloperInitiatedCancellation)

Langganan dibatalkan oleh developer.

object (ReplacementCancellation)

Langganan diganti dengan langganan baru.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

Informasi yang diberikan oleh pengguna saat mereka menyelesaikan alur pembatalan langganan (survei alasan pembatalan).

string (Timestamp format)

Waktu saat langganan dibatalkan oleh pengguna. Pengguna mungkin masih memiliki akses ke langganan setelah jangka waktu tersebut. Gunakan lineItems.expiry_time untuk menentukan apakah pengguna masih memiliki akses atau tidak.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

Alasan pengguna memilih dalam survei pembatalan.

string

Hanya ditetapkan untuk CANCEL_SURVEY_REASON_OTHERS. Ini adalah respons bebas pengguna terhadap survei.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

ID akun pengguna di layanan pihak ketiga. Hanya ada jika penautan akun terjadi sebagai bagian dari alur pembelian langganan.

string

Versi ID yang di-obfuscate yang secara unik terkait dengan akun pengguna di aplikasi Anda. Ditampilkan untuk pembelian berikut: * Jika penautan akun terjadi sebagai bagian dari alur pembelian langganan. * ID ini ditentukan menggunakan https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid saat pembelian dilakukan.

string

Versi ID yang di-obfuscate yang secara unik terkait dengan profil pengguna di aplikasi Anda. Hanya ada jika ditentukan menggunakan https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid saat pembelian dilakukan.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

ID profil Google pengguna saat langganan dibeli.

string

Nama profil pengguna saat langganan dibeli.

string

Alamat email pengguna saat langganan dibeli.

string

Nama pengguna yang ditentukan saat langganan dibeli.

string

Nama keluarga pengguna saat langganan dibeli.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

ID produk yang dibeli (misalnya, 'monthly001').

string (Timestamp format)

Waktu saat langganan telah habis masa berlakunya atau akan habis masa berlakunya kecuali jika akses diperpanjang (misalnya, perpanjangan).

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

object (AutoRenewingPlan)

Item diperpanjang otomatis.

object (PrepaidPlan)

Item tersebut bersifat prabayar.

object (OfferDetails)

Detail penawaran untuk item ini.

object (DeferredItemReplacement)

Informasi untuk penggantian item yang ditangguhkan.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  },
  "installmentDetails": {
    object (InstallmentPlan)
  }
}

boolean

Jika langganan saat ini disetel ke perpanjangan otomatis, mis. pengguna belum membatalkan langganan

object (SubscriptionItemPriceChangeDetails)

Informasi perubahan harga terakhir untuk item sejak pendaftaran langganan.

object (InstallmentPlan)

Komitmen paket cicilan dan info terkait negara bagian untuk paket perpanjangan otomatis.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

Harga berulang yang baru untuk item langganan.

enum (PriceChangeMode)

Mode perubahan harga menentukan perubahan harga item langganan.

enum (PriceChangeState)

Sebutkan perubahan harga saat ini.

string (Timestamp format)

Waktu perpanjangan saat perubahan harga akan berlaku untuk pengguna. Hal ini dapat berubah(ke waktu mendatang) karena waktu perpanjangan bergeser seperti masa jeda. Kolom ini hanya diisi jika perubahan harga tidak diterapkan.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

{
  "initialCommittedPaymentsCount": integer,
  "subsequentCommittedPaymentsCount": integer,
  "remainingCommittedPaymentsCount": integer,
  "pendingCancellation": {
    object (PendingCancellation)
  }
}

integer

Jumlah total pembayaran yang menjadi komitmen awal pengguna.

integer

Jumlah total pembayaran yang akan dilakukan pengguna setelah setiap periode komitmen. Kosong berarti paket cicilan akan kembali ke langganan perpanjangan otomatis normal setelah komitmen awal.

integer

Jumlah total komitmen pembayaran yang harus dibayar dalam siklus perpanjangan ini.

object (PendingCancellation)

Jika ada, paket cicilan ini tertunda untuk dibatalkan. Pembatalan hanya akan terjadi setelah pengguna menyelesaikan semua komitmen pembayaran.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

Jika ada, ini adalah waktu saat pembelian penambahan saldo diizinkan untuk paket prabayar. Tidak akan ada untuk paket prabayar yang sudah tidak berlaku.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

Tag penawaran terbaru yang terkait dengan penawaran. Paket ini mencakup tag yang diwarisi dari paket dasar.

string

ID paket dasar. Hadir untuk semua penawaran dan paket dasar.

string

ID penawaran. Hanya hadir untuk penawaran diskon.

{
  "productId": string
}

string

ProductId akan menggantikan productId yang ada.