Referensi Pusat Partner AWS API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat Refer [Pusat Partner AWS ensi API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).
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 Marketplace`ProductId`. 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` atau`INACTIVE`. 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 (tidak`ExpirationDate`) 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 sama`ConflictException`.
Respons mengembalikan share `Arn` (format`arn:{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` atau`Sandbox`.
+ **`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` (format`mrsa-[A-Za-z0-9]{13}`), status alokasi (`ACTIVE`saat 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` atau`Sandbox`.
+ **`MarketplaceRevenueShareIdentifier`**— pengenal bagian induk.
+ **`AllocationId`**— `mrsa-` ID alokasi untuk memperbarui.
+ **`MarketplaceRevenueShareVersion`**— versi pangsa induk saat ini untuk penguncian optimis pada alokasi. Konflik benjolan kembali`ConflictException`.
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` atau`INACTIVE`. 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 share`Arn`,, `Catalog``ProductId`, `Version` (versi induk share saat ini),, `CreatedDate``LastModifiedDate`, 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`(`ACTIVE`atau`INACTIVE`).
+ 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 terbaru`Version`,`CreatedDate`, dan`LastModifiedDate`.
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` atau`INACTIVE`.
+ **Rentang tanggal efektif** —`EffectiveDateOnOrAfter`/`EffectiveDateOnOrBefore`untuk mengambil alokasi yang tanggal efektifnya termasuk dalam jendela tertentu.
Tanggapan tersebut mencakup informasi ringkasan untuk setiap alokasi:`Id`,,`RevenueSharePercent`,`EffectiveDate`,,`ExpirationDate`, `Status``MarketplaceRevenueShareVersion`, 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` (format`arn:{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`