Udostępnij przez

Tworzenie dodatku

Użyj tej metody w interfejsie API przesyłania do sklepu Microsoft Store, aby utworzyć dodatek (znany również jako produkt w aplikacji lub IAP) dla aplikacji zarejestrowanej na koncie Centrum partnerskiego.

Notatka

Ta metoda tworzy rozszerzenie bez żadnych zgłoszeń. Aby utworzyć zgłoszenie dla dodatku, zobacz metody w temacie Zarządzanie zgłoszeniami dodatków.

Warunki wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiono, ukończ wszystkie wymagania wstępne dla interfejsu API przesyłania sklepu Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

Prośba

Ta metoda ma następującą składnię. Zapoznaj się z poniższymi sekcjami, aby zapoznać się z przykładami użycia i opisami nagłówka i treści żądania.

Metoda Żądany URI
Post https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja struna Wymagane. Token dostępu Azure AD w postaci tokenu Bearer <>.

Treść żądania

Treść żądania ma następujące parametry.

Parametr Typ Opis Wymagane
identyfikatory aplikacji tablica Tablica zawierająca identyfikator sklepu aplikacji, z którą jest skojarzony ten dodatek. W tej tablicy jest obsługiwany tylko jeden element. Tak
IdentyfikatorProduktu struna Identyfikator produktu dodatku. Jest to identyfikator, którego można używać w kodzie w celu odwoływania się do dodatku. Aby uzyskać więcej informacji, zobacz Ustaw typ produktu i identyfikator produktu. Tak
typProduktu struna Typ produktu dodatku. Obsługiwane są następujące wartości: Trwałe i Zużywalne. Tak

Przykład żądania

W poniższym przykładzie pokazano, jak utworzyć nowy dodatek eksploatacyjny dla aplikacji.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

Odpowiedź

W poniższym przykładzie pokazano treść odpowiedzi JSON dla pomyślnego wywołania tej metody. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, sprawdź zasób dodatków .

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

Kody błędów

Jeśli nie można pomyślnie ukończyć żądania, odpowiedź będzie zawierać jeden z następujących kodów błędów HTTP.

Kod błędu Opis
400 Żądanie jest nieprawidłowe.
409 Nie można utworzyć dodatku ze względu na bieżący stan lub dodatek używa funkcji Centrum partnerskiego, która jest obecnie nieobsługiwana przez interfejs API przesyłania sklepu Microsoft Store.
  • Last updated on