영어로 읽기

다음을 통해 공유

ID로 제안 가져오기

  • 아티클

에 적용: 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터

제안 ID와 일치하는 제안 리소스를 가져옵니다.

필수 구성 요소

  • 파트너 센터 인증에서 설명된 대로 자격 증명. 이 시나리오는 독립 실행형 앱 및 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.

  • 제안 ID입니다.

C#

ID별로 특정 제품을 찾으려면 IAggregatePartner.Offers 컬렉션을 사용하고 ByCountry() 호출하여 국가/지역을 설정한 다음 ByID() 메서드를 호출합니다. 그런 다음 Get() 호출하거나 Get Async()메서드를.

C# 
// IAggretagePartner partnerOperations;
// string countryCode;
// string offerId;

// retrieve the offer
var offer = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).Get();

샘플: 콘솔 테스트 앱. 프로젝트: PartnerSDK.FeatureSample 클래스: GetOffer.cs

자바

파트너 센터 Java SDK 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 커뮤니티로부터 도움을 받거나 문제가 발생하면 GitHub에 문제를 등록할 수 있습니다.

ID별로 특정 제품을 찾으려면 IAggregatePartner.getOffers 함수를 사용하고, byCountry() 함수를 호출하여 국가/지역을 설정한 다음, byID() 함수를 호출합니다. 그런 다음 get() 함수를 호출합니다.

Java 
// IAggretagePartner partnerOperations;
// String countryCode;
// String offerId;

// Retrieve the offer
Offer offer = partnerOperations.getOffers().byCountry(countryCode).byId(offerId).get();

PowerShell

파트너 센터 PowerShell 모듈 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 커뮤니티 에 도움을 받거나 문제가 발생하면 GitHub에서 이슈를 제기할 수 있습니다.

ID별로 특정 제품을 찾으려면 Get-PartnerOffer 명령을 실행하고 CountryCode 및 offerId 매개 변수를 지정합니다.

PowerShell 
# $countryCode
# $offerId

Get-PartnerOffer -Country $countryCode -OfferId $offerId

REST 요청

요청 구문

메서드 요청 URI
가져오기 {baseURL}/v1/offers/{offer-id}?country={country-id} HTTP/1.1

URI 매개 변수

이름 유형 필수 묘사
제안 ID guid Y 제안에 해당하는 GUID입니다.
국가 ID 문자열 Y 국가/지역 ID입니다.

요청 헤더

  • 문자열로 형식이 지정된 locale-id 필요합니다. 자세한 내용은 파트너 센터 REST 헤더 참조하세요.

요청 본문

없음.

요청 예제

HTTP 
GET https://api.partnercenter.microsoft.com/v1/offers/<offer-id>?country=<country-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: <locale-id>
Connection: Keep-Alive

REST 응답

성공하면 이 메서드는 응답 본문에 Offer 리소스를 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽습니다. 전체 목록은 오류 코드참조하세요.

응답 예제

HTTP 
HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Mon, 23 Nov 2015 23:13:01 GMT

{
    "id": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "name": "Office 365 Business Premium",
    "description": "For businesses with 1 to 300 users that need the latest desktop version of Office,
                    plus anywhere access to email, filesharing, and online conferencing.",
    "minimumQuantity": 1,
    "maximumQuantity": 300,
    "rank": 56,
    "uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/031C9E47-4802-4248-838E-778FB1D2CC05",
    "locale": "en-us",
    "country": "US",
    "category": {
        "id": "SmallBusiness_Key",
        "name": "Small Business",
        "rank": 30,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    },
    "prerequisiteOffers": [],
    "isAddOn": false,
    "isAvailableForPurchase": true,
    "billing": "license",
    "isAutoRenewable": true,
    "product": {
        "id": "f245ecc8-75af-4f8e-b61f-27d8114de5f3",
        "name": "Office 365 Business Premium",
        "unit": "Licenses"
    },
    "unitType": "Licenses",
    "links": {
        "learnMore": {
            "uri": "http: //g.microsoftonline.com/0BXPS00en/909",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Offer"
    }
}