View a markdown version of this page

Bekerja dengan Marketplace Revenue Shares Anda - AWS Pusat Partner
Apa itu Marketplace Revenue Share?Bekerja dengan Marketplace Revenue Shares AndaMenandai Saham Pendapatan Marketplace

Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Referensi Pusat Partner AWS API.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Bekerja dengan Marketplace Revenue Shares Anda

Marketplace Revenue Share adalah masukan untuk produk AWS Marketplace yang menyatakan porsi dari total pendapatan produk yang dikumpulkan melalui AWS Marketplace.AWS menggunakan masukan ini untuk mengkorelasikan Marketplace-collected pendapatan mitra dengan sinyal pendapatan lainnya.

Marketplace Revenue Share Service mengekspos API untuk membuat, mengambil, dan mencantumkan sumber daya bagi Pendapatan Marketplace, dan untuk mengelola alokasi mereka (persentase pembagian pendapatan yang dinyatakan mitra dan jendela tanggal efektif). Operasi AWS penandaan standar didukung pada sumber daya Marketplace Revenue Share.

Apa itu Marketplace Revenue Share?

Marketplace Revenue Share memiliki dua lapisan:

  • Saham — masukan untuk satu produk AWS Marketplace, yang diidentifikasi oleh MarketplaceProductId. Ada persis satu Marketplace Revenue Share per produk.

  • Satu atau lebih alokasi - setiap alokasi menyatakan RevenueSharePercent dan jendela tanggal efektif (EffectiveDate, opsional). ExpirationDate Sebuah saham dapat memiliki banyak alokasi dari waktu ke waktu, tetapi setiap saat hanya satu ACTIVE alokasi yang dapat berlaku.

Alokasi memiliki properti utama ini:

  • Status — ACTIVE atauINACTIVE. Pada pembuatan, status default ke. ACTIVE Hanya ACTIVE alokasi yang berpartisipasi dalam perhitungan pendapatan dan pemeriksaan tumpang tindih.

  • Tumpang tindih invarian — dalam satu bagian, tidak ada dua ACTIVE alokasi yang mungkin memiliki rentang yang tumpang tindih. [EffectiveDate, ExpirationDate] Paling banyak satu ACTIVE alokasi terbuka (tidakExpirationDate) diizinkan per saham kapan saja.

Bekerja dengan Marketplace Revenue Shares Anda

Mitra mengelola Marketplace Revenue Shares dan alokasi mereka melalui Marketplace Revenue Share Service. Siklus hidup berlangsung melalui dua aliran: alur berbagi (buat, ambil, daftar, tag) dan alur alokasi (buat, perbarui, hapus lunak, ambil, daftar).

Membuat Marketplace Revenue Share

Langkah pertama adalah membuat Marketplace Revenue Share untuk produk AWS Marketplace menggunakan aksi CreateMarketplaceRevenueShare API. Bagian diidentifikasi oleh Marketplace ProductId dan berfungsi sebagai wadah untuk semua alokasi berikutnya.

Saat membuat Marketplace Revenue Share, mitra harus menyediakan:

  • Catalog— AWS untuk produksi atau Sandbox untuk pengujian.

  • ProductId— ID produk Marketplace 25 karakter. Pola:[a-z0-9]{25}.

Mitra secara opsional dapat menyediakan:

  • Tags— hingga 50 pasangan nilai kunci untuk organisasi sumber daya pada waktu pembuatan. Gunakan TagResource untuk menambahkan tag setelah pembuatan.

  • ClientToken— token idempotensi untuk mencegah duplikat kreasi saat dicoba lagi. Maksimal 64 karakter. SDK menghasilkan token ini secara otomatis.

Validasi Produk: Saat pembuatan, layanan memverifikasi dengan AWS Marketplace bahwa produk dimiliki oleh akun penelepon atau oleh akun anak perusahaan yang terhubung ke penelepon melalui Koneksi Akun Mitra (PAC). Jika produk tidak ada atau akun pemilik tidak diotorisasi untuk pemanggil, API akan kembali ValidationException dengan alasan. PRODUCT_NOT_FOUND_OR_NOT_OWNED

Satu Saham Per Produk: CreateMarketplaceRevenueShare Panggilan kedua untuk hal yang sama ProductId dalam Catalog pengembalian yang samaConflictException.

Respons mengembalikan share Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}),, Version angka awal (yang dimulai dari 1 dan bertambah pada setiap mutasi alokasi), dan tag apa pun yang diterapkan saat pembuatan. Catalog ProductId

Menambahkan alokasi

Setelah Marketplace Revenue Share dibuat, mitra mendeklarasikan persentase bagi hasil dan jendela tanggal efektif dengan membuat alokasi melalui tindakan API. CreateMarketplaceRevenueShareAllocation

Saat membuat alokasi, mitra harus menyediakan:

  • Catalog— AWS atauSandbox.

  • MarketplaceRevenueShareIdentifier— pengenal bagian induk.

  • RevenueSharePercent— persentase pendapatan produk yang dikumpulkan melalui Marketplace disediakan sebagai desimal (misalnya, 0.45 untuk 45%).

  • EffectiveDate— tanggal kalender ketika alokasi ini menjadi efektif. Format: YYYY-MM-DD.

Respons mengembalikan alokasi Id (formatmrsa-[A-Za-z0-9]{13}), status alokasi (ACTIVEsaat pembuatan), dan pembagian induk yang terbentur Version (bilangan bulat versi tunggal per saham ditabrak pada setiap mutasi alokasi, digunakan untuk penguncian optimis pada pembaruan alokasi berikutnya).

Memperbarui alokasi

Mitra dapat memperbarui alokasi menggunakan tindakan UpdateMarketplaceRevenueShareAllocation API. Bidang yang dapat diperbarui bergantung pada apakah alokasi tersebut bertanggal di masa depan, efektif saat ini, atau bertanggal lalu.

Saat memperbarui alokasi, mitra harus menyediakan:

  • Catalog— AWS atauSandbox.

  • MarketplaceRevenueShareIdentifier— pengenal bagian induk.

  • AllocationId— mrsa- ID alokasi untuk memperbarui.

  • MarketplaceRevenueShareVersion— versi pangsa induk saat ini untuk penguncian optimis pada alokasi. Konflik benjolan kembaliConflictException.

Mitra secara opsional dapat menyediakan:

  • RevenueSharePercent— persentase pembagian pendapatan yang diperbarui. Dapat diedit hanya pada alokasi masa depan.

  • EffectiveDate— tanggal efektif yang diperbarui. Dapat diedit hanya pada alokasi masa depan.

  • ExpirationDate— tanggal kedaluwarsa yang diperbarui. Dapat diedit pada alokasi masa depan (nilai apa pun> EffectiveDate) dan pada alokasi yang efektif saat ini atau terbuka (nilai apa pun). ≥ today

  • Status— ACTIVE atauINACTIVE. Pengaturan untuk INACTIVE soft-menghapus alokasi. Dapat diedit hanya pada alokasi masa depan.

  • ClientToken— token idempotensi.

Melihat detail Pembagian Pendapatan Marketplace

Partner dapat mengambil informasi lengkap untuk satu Marketplace Revenue Share menggunakan tindakan GetMarketplaceRevenueShare API. Ini mengembalikan shareArn,, CatalogProductId, Version (versi induk share saat ini),, CreatedDateLastModifiedDate, dan tag apa pun yang diterapkan ke share.

Partner dapat mengambil satu alokasi menggunakan aksi GetMarketplaceRevenueShareAllocation API dengan alokasi. Id Ini mengembalikan:

  • Alokasi Id dan bagian induk. MarketplaceRevenueShareArn

  • RevenueSharePercent, EffectiveDate, ExpirationDate.

  • Status(ACTIVEatauINACTIVE).

  • Bagian induk MarketplaceRevenueShareVersion untuk penguncian optimis pada pembaruan berikutnya.

  • CreatedDate dan LastModifiedDate.

Daftar Saham Pendapatan Marketplace

Partner dapat melihat semua Marketplace Revenue Shares yang dimiliki oleh akun mereka menggunakan tindakan ListMarketplaceRevenueShares API. Ini mengembalikan daftar ringkasan berbagi paginasi.

Mitra dapat memfilter hasil dengan:

  • Catalog— AWS atau Sandbox (wajib).

  • ProductIds— daftar ID produk Marketplace tertentu untuk diambil.

Tanggapan tersebut mencakup ringkasan untuk setiap saham:Arn,Catalog,ProductId, yang terbaruVersion,CreatedDate, danLastModifiedDate.

Gunakan MaxResults dan NextToken untuk paginasi melalui set hasil yang besar.

Alokasi daftar

Partner dapat mencantumkan alokasi untuk Marketplace Revenue Share tertentu menggunakan tindakan ListMarketplaceRevenueShareAllocations API. Ini mengembalikan daftar ringkasan alokasi paginasi dengan kemampuan pemfilteran.

Mitra dapat memfilter hasil dengan:

  • Status— ACTIVE atauINACTIVE.

  • Rentang tanggal efektif —EffectiveDateOnOrAfter/EffectiveDateOnOrBeforeuntuk mengambil alokasi yang tanggal efektifnya termasuk dalam jendela tertentu.

Tanggapan tersebut mencakup informasi ringkasan untuk setiap alokasi:Id,,RevenueSharePercent,EffectiveDate,,ExpirationDate, StatusMarketplaceRevenueShareVersion, dan cap waktu audit.

Menandai Saham Pendapatan Marketplace

Operasi AWS penandaan standar didukung pada sumber daya Marketplace Revenue Share:

  • TagResource— menambah atau menimpa tag pada Marketplace Revenue Share. Maksimal 50 tag per saham.

  • UntagResource— hapus tag tertentu dengan kunci.

  • ListTagsForResource— mengambil semua tag yang saat ini diterapkan ke Marketplace Revenue Share.

Alokasi tidak mendukung tag. Tandai bagian induk untuk mengatur alokasi terkait.

Setiap operasi penandaan menerima share Arn (formatarn:{partition}:partnercentral:{region}:{account-id}:catalog/{catalog}/marketplace-revenue-share/{productId}) sebagai pengenal sumber daya. Standar AWS tag-on-create juga didukung melalui bidang pada. Tags CreateMarketplaceRevenueShare