API로 기본 작업을 수행하는 것은 API 사용을 시작하는 좋은 방법입니다.
기본 요건
시작하기 전에 다음을 완료하세요.
- 유효한 CSS Center 계정이 있어야 합니다.
- API 개발자를 등록합니다.
- 권한 설정이 올바른지 확인합니다.
- CSS API가 사용 설정되어 있는지 확인합니다.
- 환경에 맞는 클라이언트 라이브러리가 설치되어 있는지 확인합니다.
자세한 내용은 빠른 시작을 참고하세요.
CSS API 사용 설정
CSS API를 사용하려면 다음과 같이 개발자 등록 방법을 사용하여 CSS Center 계정과 Google Cloud 프로젝트를 연결해야 합니다.
CSS Center와 Google Cloud 프로젝트 연결: 호출자가 액세스 토큰 또는 API 키를 기반으로 Google Cloud 프로젝트에 액세스할 수 있고 CSS Center 계정의 승인된 사용자이므로 연결이 자동으로 설정됩니다.
API 개발자 등록
CSS 센터 계정에 API 개발자 사용자 추가: 사용자가 이미 있는 경우 새 'API 개발자' 액세스 유형이 부여됩니다. 신규 사용자의 경우 CSS Center 이메일 초대를 받습니다.
등록 후 GetDeveloperRegistration를 사용하여 등록 상태를 확인하거나 UnregisterGCP를 사용하여 등록을 취소할 수 있습니다. 다음 등록 호출을 사용할 수 있습니다.
POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
요청이 성공적으로 실행되면 다음 응답이 표시됩니다.
{
"developerRegistration":
{
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": [
"GOOGLE_CLOUD_PROJECT_ID"
]
}
}
CSS 제품
제품 하위 API와 마찬가지로 CSS API는 CssProductInput와 ListCssProduct를 구분합니다. InsertCssProductInput를 사용하여 제품을 삽입합니다.
내부 시스템에서 제품을 처리하면 (몇 분 정도 걸릴 수 있음) ListCssProducts로 제품을 가져옵니다.
raw_provided_id를 사용하여 제품을 식별합니다. 자체 시스템에서 이미 사용 중인 식별자를 사용하는 것이 좋습니다. 또는 다음 중 하나를 사용하여 만드는 일반적인 방법이 있습니다.
- 전역 고유 식별자 (GUID)
- 범용 고유 식별자 (UUID)
- 연결된 고유 제품 속성 (예: brand_model_color_size)
자세한 내용은 제품 삽입/나열/업데이트/삭제를 참고하세요.
기본 작업
다음은 시도해 볼 수 있는 몇 가지 기본적인 요청입니다.
InsertCssProductInput를 사용하여 테스트 제품을 삽입합니다. 전송할 속성에 관한 도움말은 이 샘플 코드를 검토하세요.ListCssProducts를 사용하여 모든 제품을 나열합니다. 제품을 삽입한 후 등록에 표시되기까지 약간의 처리 지연이 발생합니다. 바로 표시되지 않으면 몇 초 후에 다시 시도하세요.cssproductinput.name를 사용하여UpdateCssProductInput를 사용하여 단일 제품을 업데이트합니다. 업데이트해야 하는 속성만 전송하면 됩니다. 예를 들어 샘플 코드를 참고하세요.DeleteCssProductInpu을 사용하여 테스트 제품을 삭제하고raw_provided_id를 제공합니다.
제한사항
개별 제품을 삽입하거나 삭제하는 데 시간이 오래 걸릴 수 있습니다. 성능을 개선하려면 비동기를 사용하여 성능을 개선하세요. 이렇게 하면 API를 병렬로 호출할 수 있습니다.
계정 나열 및 라벨 지정
CSS API의 라벨 관리를 사용하면 맞춤 태그를 사용하여 클라이언트 판매자 센터 계정을 프로그래매틱 방식으로 정리할 수 있습니다. 이 기능을 사용하면 고객을 유형이나 전략별로 효율적으로 분류하여 더 나은 조직화와 간소화된 운영이 가능합니다. API를 사용하여 라벨에 대해 다음 기능을 실행할 수 있습니다.