시작하기

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

이 가이드에서는 Manufacturer Center API를 사용하여 첫 번째 애플리케이션을 만드는 방법을 설명합니다. 코딩을 시작하기 전에 해야 할 몇 가지 작업이 있습니다.

REST 지원

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

  • 브랜드 소유자 및 데이터 파트너를 위한 제품입니다.
  • 및 인증 기관을 위한 ProductCertification이 필요합니다.

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

Manufacturer Center 계정 설정

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

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

첫 번째 API 요청을 해 보세요 (코드 한 줄도 필요 없음).

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

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

  3. API 탐색기의 인증 드롭다운 메뉴에 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 계정에서 사용할 새 서비스 계정을 설정하는 방법에 대한 자세한 내용은 서비스 계정 가이드를 참고하세요.

Java를 사용한 첫 번째 승인된 API 요청

이제 서비스 계정을 설정하고 서비스 계정 ID를 Manufacturer Center 계정에 추가했으므로 제공되는 샘플 코드를 사용하여 계정에 액세스할 수 있습니다. 이 가이드에서는 Java 샘플을 사용하여 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. 이 시점에서 Java 프로그램은 실행을 완료하고, 찾은 제품 목록 또는 계정에 제품이 없다는 메시지를 출력합니다. '사용자가 계정 1234567890에 액세스할 수 없습니다'와 같은 오류가 표시되는 경우 Manufacturer Center에서 서비스 계정 사용자를 승인된 사용자로 설정하지 않았기 때문일 수 있습니다. API의 관점에서 API 콘솔 프로젝트는 승인된 Manufacturer Center 관리자 목록에 없는 사용자를 대신하여 요청을 보냈으므로 이 요청은 거부됩니다.

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