시작하기

Manufacturer Center (MfC) API를 사용하면 앱이 Manufacturer Center 플랫폼과 직접 상호작용할 수 있습니다. 시작하는 데 도움이 되도록 자바와 .NET으로 된 코드 샘플이 제공됩니다.

이 가이드에서는 Manufacturer Center API를 사용하여 첫 번째 애플리케이션을 만드는 방법을 설명합니다. 코딩을 시작하려면 먼저 다음과 같은 몇 가지 작업을 수행해야 합니다.

REST 지원

REST API는 두 가지 유형의 리소스에 대한 기본 CRUD 작업을 지원합니다.

이 문서의 나머지 부분은 주로 Product에 대해 작성하지만 프로세스는 ProductCertification과 유사합니다.

Manufacturer Center 계정 설정

  1. Manufacturer Center 계정을 만듭니다.

  2. 이 Manufacturer Center 계정을 만들 때 사용한 이메일은 나중에 필요하므로 기억해 두어야 합니다. 스크린샷에는 manufacturer_user@example.com으로 표시됩니다.

코드 줄 없이 첫 번째 API를 요청합니다.

  1. Accounts.Products.list 개발자 문서의 API 탐색기로 이동하세요.

  2. 로그인한 Google 계정이 설정 탭의 '사용자' 설정에 표시되는지 확인합니다.

  3. API 탐색기의 Authentication 드롭다운 메뉴에서 Google OAuth 2.0이 선택되었는지 확인합니다.

  4. accounts/{account_id}을 입력하고 {account_id}를 Manufacturer Center 계정의 제조업체 ID를 양식의 '상위' 필드에 입력하고 실행을 클릭합니다.

  5. 성공적인 응답이 표시됩니다. 수고하셨습니다. 처음으로 Manufacturer Center API를 요청했습니다.

  6. Manufacturer Center에 아직 제품이 없으면 목록에 제품이 표시되지 않습니다. 이제 다른 요청을 통해 무엇을 하는지 살펴볼 수 있습니다. RESTful API이므로 모든 요청이 비슷하게 작동합니다. 제품을 준비한 후 Accounts.Products.get를 사용해 보는 것이 좋습니다.

Google API 콘솔 프로젝트 만들기

Manufacturer Center API에 대한 요청은 API 콘솔 프로젝트를 통해 이루어집니다. 여기서는 본인의 Manufacturer Center 계정에 액세스한다고 가정하므로 서비스 계정을 사용하여 인증 과정을 간소화하는 것이 좋습니다. Manufacturer Center 계정에서 사용할 새 서비스 계정을 설정하는 방법에 대한 자세한 내용은 서비스 계정 가이드를 참조하세요.

자바를 사용하는 첫 번째 승인된 API 요청

이제 서비스 계정을 설정하고 Manufacturer Center 계정에 서비스 계정 ID를 추가했으므로 사용 가능한 샘플 코드를 사용하여 계정에 액세스할 수 있습니다. 이 가이드에서는 자바 샘플을 사용하여 API를 사용하는 방법을 보여줍니다.

  1. 아직 설치하지 않은 경우 Apache Maven을 설치합니다.

  2. GitHub 페이지에서 쇼핑 샘플을 다운로드하세요.

  3. java 하위 디렉터리 내에서 자바 샘플을 빌드합니다.

    $ mvn compile
    
  4. 이제 ProductsListSample (ProductCertification의 예는 ListProductCertificationsSample)를 실행합니다.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  5. 소스 파일과 함께 제공되는 README의 구성 안내를 따르지 않은 경우 샘플 구성을 찾을 수 없다는 오류가 표시됩니다. README의 안내에 따라 구성 디렉터리를 만들고 적절한 정보로 채웁니다. 서비스 계정을 설정하는 동안 다운로드한 JSON 파일은 해당 디렉터리에 파일 이름이 service-account.json여야 합니다. 다음 환경 변수를 설정하여 파일의 위치를 코드에 알려야 합니다.

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
    
  6. 이제 샘플 구성을 설정했으므로 ProductsListSample 코드를 다시 실행합니다.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
    
  7. 이 시점에서 자바 프로그램 실행이 완료되고 발견한 제품 목록이나 계정에 제품이 없다는 메시지를 출력합니다. '사용자가 계정 1234567890에 액세스할 수 없음'과 같은 오류가 표시된다면 Manufacturer Center에서 서비스 계정 사용자를 승인된 사용자로 설정하지 않았기 때문일 가능성이 높습니다. API의 관점에서 API 콘솔 프로젝트는 승인된 Manufacturer Center 관리자 목록에 없는 사용자를 대신하여 요청을 전송했으므로 이 요청은 거부합니다.

  8. ProductsListSample는 읽기 전용 요청이므로 원하는 횟수만큼 실행할 수 있습니다. 자바 및 .NET용으로 만든 다른 샘플도 살펴볼 수 있습니다.