시작하기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Manufacturer Center API를 통해 앱은 Manufacturer Center 플랫폼과 직접 상호작용할 수 있습니다. 시작하는 데 도움이 되도록 자바 및 .NET으로 코드 샘플을 제공합니다.

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

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 계정의 Manufacturer ID로 바꾸어 양식의 '상위' 필드에 실행을 클릭합니다.

    참고: 이전에 OAuth2 권한을 부여하지 않은 경우 이제 호출을 승인하라는 메시지가 표시됩니다.

  5. 성공적인 응답이 표시됩니다. 수고하셨습니다. Manufacturer Center API를 처음으로 요청하셨습니다.
  6. Manufacturer Center에 아직 제품이 없다면 목록에 제품이 없습니다. 이제 다른 요청으로 이동하여 해당 기능을 살펴보겠습니다. RESTful API이므로 모든 요청이 유사하게 작동합니다. 제품을 확보한 후 Accounts.Products.get를 사용해 보세요.

Google API 콘솔 프로젝트 만들기

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

참고: 자체 Manufacturer Center 계정이 있는 고객을 대신하여 전화를 걸려면 요청 승인 가이드를 참고하세요.

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

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

  1. 아직 설치하지 않았다면 Apache Maven을 설치합니다.
  2. GitHub 페이지에서 쇼핑 샘플을 다운로드합니다.

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

    $ mvn compile
            

  4. 이제 ProductsListSample 코드를 실행합니다.

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
            

  5. 소스 파일과 함께 제공되는 README의 구성 안내를 따르지 않은 경우 샘플 구성을 찾을 수 없다는 오류가 표시됩니다. README의 안내에 따라 구성 디렉터리를 만들고 적절한 정보를 입력합니다. 서비스 계정을 설정하는 동안 다운로드한 JSON 파일은 파일 이름이 service-account.json인 디렉터리에 있어야 합니다.

  6. 샘플 구성을 설정했으므로 이제 ProductsListSample 코드를 다시 실행합니다.

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

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