Mengelola hak untuk penawaran pribadi

Saat pelanggan membeli penawaran pribadi, Google akan membuat hak, yang menunjukkan bahwa pelanggan telah membeli penawaran dari Cloud Marketplace.

Dokumen ini meninjau cara mengelola hak untuk penawaran pribadi Anda dengan menggunakan Producer Portal dan Partner Procurement API. Anda dapat menggunakan Portal Produser untuk menyetujui hak penawaran. Untuk tugas pengelolaan hak penawaran lainnya, Anda harus menggunakan Partner Procurement API.

Menyetujui hak menggunakan Producer Portal

Anda dapat menggunakan Producer Portal untuk menyetujui hak untuk penawaran pribadi. Untuk menyetujui hak menggunakan Producer Portal, selesaikan langkah-langkah berikut:

  1. Di Producer Portal, buka halaman Penawaran Pribadi.

  2. Klik Kelola penawaran Anda.

Mengelola hak dengan menggunakan Partner Procurement API

Bagian berikut menjelaskan cara mengelola hak untuk penawaran pribadi dengan menggunakan Partner Procurement API.

Untuk mengetahui detail tentang cara menggunakan Partner Procurement API untuk penawaran pribadi, buka dokumentasi referensi.

Menyetujui hak

Saat pelanggan membeli penawaran pribadi, Cloud Marketplace akan membuat hak dan mengirim pesan Pub/Sub berikut ke produk Anda:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_CREATION_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newOfferDuration": "P1Y6M", // Contract duration for the offer
  "newOfferEndTime": "", // Ending time for the offer
  },
}

Dalam contoh ini, ENTITLEMENT_ID adalah ID yang dibuat oleh Cloud Marketplace.

Jika penawaran dibuat dengan durasi, pesan akan menampilkan durasi dalam tahun dan bulan, dan kolom newOfferEndTime kosong. Jika penawaran dibuat dengan waktu berakhir yang ditentukan, pesan akan menampilkan waktu berakhir penawaran, dan kolom newOfferDuration kosong.

Di sistem Anda, perbarui akun pengguna untuk menunjukkan bahwa mereka telah membeli penawaran. Kemudian, untuk menyetujui hak, buat permintaan HTTP POST ke Partner Procurement API, dan kirim ENTITLEMENT_ID yang Anda setujui:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approve

Menolak hak

Untuk menolak hak, gunakan metode reject dalam permintaan HTTP POST Anda:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:reject

Mengganti penawaran yang aktif

Bergantung pada cara Anda menyiapkan penawaran pribadi, pelanggan mungkin dapat mengganti penawaran mereka. Jika pelanggan memilih penawaran pribadi baru, Anda akan menerima pesan Pub/Sub, dalam format berikut:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_PLAN_CHANGE_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "newPlan": "ultimate",   // New plan for the offer,
  "newOffer": "OFFER2",    // New offer,
  "updateTime": "...",
  "newOfferDuration": "P2Y",   // Contract duration for the new offer
  },
}

Dalam contoh ini, OFFER2 adalah penawaran pengganti dan ENTITLEMENT_ID adalah ID yang dibuat oleh Cloud Marketplace. Durasi penawaran diberikan dalam tahun dan bulan.

Untuk menyetujui penggantian penawaran, buat permintaan HTTP POST berikut ke Partner Procurement API:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approvePlanChange

Isi permintaan harus memiliki rencana untuk penawaran yang sedang disetujui:

{
  "pendingPlanName": PLAN_NAME
}

Setelah perubahan disetujui, Anda akan menerima pesan Pub/Sub lain saat perubahan diterapkan. Dalam pesan, kolom eventType berubah menjadi ENTITLEMENT_PLAN_CHANGED. Untuk memeriksa status rencana, buat permintaan HTTP GET berikut ke Partner Procurement API:

GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID

Responsnya mirip dengan berikut ini, dengan kolom status menunjukkan apakah penawaran baru aktif, atau apakah perubahan penawaran masih tertunda:

{
  "name": "providers/PARTNER_ID/entitlements/ENTITLEMENT_ID",
  "provider": "PARTNER_ID",
  "account": "USER_ACCOUNT_ID",
  "product": "example-server",
  "Offer":   "OFFER1",
  "plan": "pro",
  "state": "ENTITLEMENT_PENDING_PLAN_CHANGE",
  "newPendingOffer": "OFFER2",
  "newPendingPlan": "ultimate",
  "newOfferDuration": "P2Y",
  "newOfferEndTime": "",
  ...
}

Menyelesaikan tugas hak lainnya

Untuk tugas hak lainnya yang tidak khusus untuk penawaran pribadi, lihat dokumentasi publik Cloud Marketplace:

Daftar jenis peristiwa untuk tugas akun penawaran pribadi

Tabel berikut menyertakan eventType yang mungkin diterima produk Anda dalam pesan Pub/Sub untuk penawaran pribadi.

Untuk mengetahui daftar lengkapnya, lihat Daftar jenis peristiwa untuk tugas akun.

eventType Deskripsi
ENTITLEMENT_OFFER_ENDED Menunjukkan bahwa penawaran pribadi pelanggan telah berakhir. Penawaran tersebut memicu peristiwa ENTITLEMENT_CANCELLED atau tetap aktif dengan harga tanpa diskon.

Langkah selanjutnya