Udostępnij przez

Pobierz wszystkie dodatki

Użyj tej metody w interfejsie API do przesyłania danych w sklepie Microsoft Store, aby pobrać dane dla wszystkich rozszerzeń dla wszystkich aplikacji zarejestrowanych na twoim koncie Centrum partnerskiego.

Wymagania wstępne

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

  • Jeśli jeszcze tego nie zrobiłeś(-łaś), zrealizuj wszystkie wymagania wstępne dla API przesyłania do 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.

Żądanie

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 Żądanie URI
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Wszystkie parametry żądania są opcjonalne dla tej metody. Jeśli wywołasz tę metodę bez parametrów, odpowiedź zawiera dane wszystkich dodatków dla wszystkich aplikacji zarejestrowanych na twoim koncie.

Parametr Typ Opis Wymagane
Do góry int (integer) Liczba elementów do zwrócenia w żądaniu (czyli liczba dodatków do zwrócenia). Jeśli twoje konto ma więcej dodatków niż wartość określona w zapytaniu, treść odpowiedzi zawiera względną ścieżkę URI, którą można dołączyć do URI metody, aby zażądać następnej strony danych. Nie.
pominąć int (integer) Liczba elementów do pominięcia w zapytaniu przed zwróceniem pozostałych elementów. Użyj tego parametru do przechodzenia po zestawach danych. Na przykład top=10 i skip=0 pobiera elementy od 1 do 10, top=10 i skip=10 pobiera elementy od 11 do 20 itd. Nie.

Ciało żądania

Nie należy podawać treści żądania dla tej metody.

Prośba o przykłady

W poniższym przykładzie pokazano, jak pobrać wszystkie dane dotyczące dodatków dla wszystkich aplikacji, które zostały zarejestrowane na twoim koncie.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer <your access token>

W poniższym przykładzie pokazano, jak pobrać tylko 10 pierwszych dodatków.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

W poniższym przykładzie pokazano zwrotną treść odpowiedzi JSON dla pomyślnego żądania dotyczącego pierwszych 5 dodatków zarejestrowanych na koncie dewelopera spośród 1072 dodatków. Dla zwięzłości w tym przykładzie pokazano tylko dane dla dwóch pierwszych dodatków zwróconych przez żądanie. Aby uzyskać więcej informacji na temat wartości w treści odpowiedzi, zobacz następującą sekcję.

{
  "@nextLink": "inappproducts/?skip=5&top=5",
  "value": [
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMP",
      "productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243619",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243705",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
      }
    },
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMN",
      "productId": "6a3c9788-a350-448a-bd32-16160a13018a",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243538",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243106",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
      }
    },

  // Other add-ons omitted for brevity...
  ],
  "totalCount": 1072
}

Ciało odpowiedzi

Wartość Typ Opis
@nextLink sznurek Jeśli istnieją dodatkowe strony danych, ten ciąg zawiera ścieżkę względną, którą można dołączyć do podstawowego identyfikatora URI żądania https://manage.devcenter.microsoft.com/v1.0/my/, aby zażądać następnej strony danych. Jeśli na przykład parametr w początkowej treści żądania jest ustawiony na 10, ale na twoim koncie jest zarejestrowanych 100 dodatków, treść odpowiedzi będzie zawierać wartość @nextLinkinappproducts?skip=10&top=10, co wskazuje, że można wywołać https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10, aby zażądać kolejnych 10 dodatków.
wartość układ Tablica zawierająca obiekty, które zawierają informacje o każdym dodatku. Aby uzyskać więcej informacji, zapoznaj się z zasobem dodatku .
łączna liczba int (integer) Liczba obiektów aplikacji w tablicy wartości w treści odpowiedzi.

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
404 Nie znaleziono dodatków.
409 Aplikacje lub dodatki używają funkcji Centrum partnerskiego, które są obecnie nieobsługiwane przez interfejs API przesyłania sklepu Microsoft Store.
  • Last updated on