이 문서에서는 권장사항에 대한 가이드라인을 제공합니다. 자세한 내용은 성능 팁을 참고하세요.
API를 사용해야 하는 경우
프로그래매틱 방식으로 요청을 보내려면 다음 단계를 따르세요.
워크플로의 모든 부분을 자동화하든 ERP (전사적 자원 관리) 시스템에 후크를 만들든 Content API를 사용하면 인벤토리가 변경되는 즉시 업데이트를 전송할 수 있습니다.
즉각적인 피드백을 받으려면
Content API에서는 데이터 피드가 처리된 후 이메일 요약을 통해 응답을 받는 대신 모든 요청에 대한 응답을 즉시 받을 수 있습니다. 대규모 배치 요청의 경우 5~10초의 지연 시간이 예상됩니다.
제품 데이터를 자주 변경하는 경우
Content API를 사용하면 하루에 여러 번 빠르게 움직이는 제품 인벤토리를 점진적으로 업데이트할 수 있지만, 매번 전체 데이터 피드를 전송하는 것은 불가능합니다. 업데이트가 개별적으로 제공되면 여러 업데이트가 모일 때까지 기다리지 말고 개별적으로 전송하세요. 마찬가지로 업데이트를 일괄적으로 사용할 수 있는 경우 개별 요청으로 나누지 말고 일괄적으로 전송하세요.
여러 하위 계정을 관리하는 경우
새로 생성된 판매자 센터 계정은 자체 제품 데이터 세트를 보유하는 단일 계정입니다. 이 방법은 대부분의 경우에 적합하지만 계정이 커지면 제품에 더 복잡한 관리 시스템이 필요할 수 있습니다. 이 경우 멀티 클라이언트 계정(MCA)을 사용하는 것이 좋습니다. MCA 계정의 API 수준 관리는 계정 서비스를 통해 수행할 수 있으며, 이를 통해 하위 계정을 프로그래매틱 방식으로 추가하고 관리할 수 있습니다. MCA 계정을 획득하는 방법에 대한 자세한 내용은 여기를 참고하세요.
API 사용 방법
데이터 피드를 사용하는 것처럼 API를 사용하지 마세요.
products 리소스를 사용하는 경우 전체 제품 피드를 매일 업데이트하지 마세요.
대신 데이터가 실제로 변경된 제품만 구체적으로 업데이트하세요. products 리소스를 통해 전체 데이터 피드를 전송하면 Google과 사용자 모두 더 많은 시간과 리소스를 소비합니다.
업로드한 제품 정보를 정기적으로 가져오는 데 API를 사용하지 마세요.
특정 판매자 센터 계정에서 제품 정보를 유지 관리하는 경우 products.get 또는 products.list 메서드를 통해 Content API에서 제품 정보를 정기적으로 요청하지 마세요. 정보를 업로드하는 클라이언트의 경우 이러한 메서드는 Content API를 사용하는 솔루션을 설계할 때 문제를 디버깅하는 데 도움이 될 수 있습니다. 하지만 이러한 클라이언트가 제품 정보를 정기적으로 가져오는 데는 적합하지 않습니다. 오프라인 제품 데이터베이스와 같은 제품 정보의 다른 소스가 있어야 하며 판매자 센터의 제품은 해당 소스의 콘텐츠를 반영해야 합니다.
데이터 피드와 Content API를 모두 사용하여 제품 항목을 제출하지 마세요.
상품 제출을 위해 API로 전환하려는 경우 더 이상 데이터 피드를 사용하여 제품 상품을 제출하지 않는지 확인하세요. 두 매체에 모두 상품을 계속 제출하면 예기치 않은 결과가 발생할 수 있습니다.
API와 데이터 피드를 안전하게 함께 사용할 수 있는 방법이 있나요?
API의 데이터 피드 서비스를 사용하여 데이터 피드를 조작할 수 있습니다. 이렇게 하면 대규모 데이터 피드 관리가 훨씬 쉬워지지만, 예기치 않은 결과가 발생할 수 있으므로 피드와 동시에 API를 사용하여 제품을 삽입하거나 업데이트해서는 안 됩니다.
피드와 API를 함께 사용하는 허용되는 방법의 다른 예는 다음과 같습니다.
API에서 읽기 전용 요청 (get 또는 list) 실행: 일부 판매자는 API를 사용하여 제품에 관한 정보와 상태 업데이트를 가져오려고 합니다. 제품 정보는 피드에 의해서만 업데이트되므로 허용됩니다.
API를 사용하여 하위 계정 (계정 서비스) 또는 계정 수준 세금 및 배송 설정 (Accounttax Service 및 Shippingsettings Service)을 관리합니다. 이러한 기능은 데이터 피드에서 제공할 수 없으므로 API를 사용하여 이러한 기능을 관리하는 것과 충돌하지 않습니다.
데이터 피드 사용에서 API만 사용으로 또는 그 반대로 전환하려면 어떻게 해야 하나요?
현재 데이터 피드를 사용하고 있으며 제품 업데이트에 API만 사용하도록 전환하려면 API를 사용하여 제품 데이터를 다시 업로드해야 합니다. 제품 서비스를 사용하여 특정 제품을 업데이트하면 API가 제품 정보를 제어하므로 데이터 피드에서 제품을 삭제하거나 데이터 피드 자체를 삭제해도 더 이상 판매자 센터 계정에서 제품 정보가 삭제되지 않습니다. 데이터 피드 또는 데이터 피드 자체에서 제품을 삭제하려면 데이터 피드 업데이트가 없는지 확인하세요. 그렇지 않으면 데이터 피드가 소유권을 다시 가져오고 데이터 피드에서 제품을 삭제하면 제품이 삭제됩니다.
현재 제품 정보에 API만 사용하고 있으며 데이터 피드를 제품 정보의 기본 소스로 사용하려는 경우 판매자 센터 계정에 새 데이터 피드를 추가하기만 하면 나열된 제품의 소유권을 가져갈 수 있습니다. API에서만 업로드되었으며 만료 전에 삭제하려는 제품이 있는 경우 판매자 센터 또는 API를 통해 삭제해야 합니다.
Content API for Shopping을 사용하여 제품으로 여러 국가를 타겟팅하려면 어떻게 해야 하나요?
Content API를 통해 제출된 제품의 광고 및 무료 등록정보로 여러 국가를 타겟팅하려면 판매자 센터의 Content API 기본 피드에서 추가 국가를 구성하거나 products 리소스의 shipping 필드를 통해 추가 국가를 추가하세요.
콘텐츠 API 기본 피드 설정을 수정하는 방법의 예는 아래를 참고하세요.
자세한 내용은 여러 국가에서 쇼핑 광고 및 무료 등록정보 타겟팅하기를 참고하세요.
클라이언트 라이브러리가 최신 상태인지 확인
Google 클라이언트 라이브러리를 사용하여 Content API와 상호작용하는 경우 선택한 프로그래밍 언어의 패키지 관리자를 사용하여 라이브러리 버전이 최신인지 확인하세요. 자세한 내용은 샘플 및 라이브러리에서 선택한 언어의 개발자 가이드를 참고하세요.
대상 유형 속성을 사용하여 다양한 쇼핑 프로그램에 표시되는 제품을 관리하세요.
Content API는 판매자 센터에서 구성된 대로 Content API 피드의 기본 설정을 자동으로 채택합니다. includedDestinations 또는 excludedDestinations 제품 속성을 사용하여 피드 내에서 또는 Content API를 통해 제품 수준에서 프로그램 참여를 관리할 수 있습니다.
API 피드가 Google에서 구매(이전 명칭: Shopping Actions)와 같은 프로그램에 선택되었지만 특정 제품을 제외하려면 excludedDestinations 속성을 사용하고 Shopping Actions을 값으로 지정하세요. 오류가 없으면 판매자 센터의 기본 피드 설정이 덮어쓰여 해당 상품이 'Google에서 구매'(이전 명칭: Shopping Actions)에 표시되지 않습니다. 반대로 피드가 쇼핑과 같은 프로그램에 선택되지 않은 경우 includedDestinations 속성과 Shopping_ads 값을 사용하여 개별 상품을 포함할 수 있으며 상품이 쇼핑 광고에 표시됩니다.
includedDestinations 및 excludedDestinations 제품 속성에 관한 자세한 내용은 고객센터를 참고하세요.
상품이 만료되기 전에 업데이트하세요
마지막 업데이트 후 30일이 지나거나 지정된 만료일이 더 빠른 경우 만료되기 전에 상품이 변경되지 않으면 상품이 비활성화되지 않도록 상품을 업데이트하세요. 변경되지 않은 항목이 많거나 마지막 업데이트 시간을 추적할 수 없어 여러 항목을 업데이트해야 하는 경우 모든 항목을 동시에 업데이트하지 말고 여러 날에 걸쳐 부하를 균등하게 분산하세요.
Content API 피드를 삭제하면 제품이 사라질 수 있습니다.
Content API를 통해 channel:online로 제품을 처음 업로드하면 판매자 센터에 Content API라는 새 피드가 표시됩니다. Content API를 통해 channel:local로 제품을 처음 업로드하면 판매자 센터에 Content API라는 제목과 오프라인 제품이라는 부제목이 있는 새 피드가 표시됩니다. 온라인 또는 로컬 Content API 피드를 실수로 삭제하지 않도록 합니다. 삭제하는 피드에 따라 Content API를 통해 판매자 센터에 추가한 온라인 또는 오프라인 제품이 삭제됩니다.
custombatch 메서드를 사용하여 동일한 서비스에 대한 여러 요청 일괄 처리
동일한 서비스에 여러 개의 순차적 또는 병렬 요청을 보내는 대신 원하는 요청이 모두 포함된 단일 custombatch 요청을 보내세요. 이렇게 하면 API 엔드포인트에 대한 요청 지연 시간이 각 개별 요청이 아닌 custombatch 호출에 대해서만 한 번 발생하므로 특히 순차적 요청을 하는 경우에 중요합니다.
단일 배치에서 단일 항목에 여러 업데이트를 전송하지 마세요.
업데이트 순서가 불확실하므로 예기치 않은 결과가 발생할 수 있으며 충돌 오류가 발생할 수 있습니다.
변경되지 않은 항목에 대한 업데이트를 보내지 않음
상품이 만료되지 않는 한 신규, 변경 또는 삭제된 상품 항목에 대한 요청만 전송해야 합니다.
가격 또는 재고 상황이 빠르게 변하는 경우 보조 피드 사용
제품의 가격, 재고, 할인 정보를 최신 상태로 유지하는 데 문제가 있는 경우 products 리소스의 보조 피드를 사용하여 해당 속성만 업데이트하는 것이 좋습니다. 보조 피드 업데이트는 작기 때문에 특정 기간에 전체 제품 업데이트보다 훨씬 많은 보조 피드 업데이트를 할 수 있어 제품의 가격과 재고를 방문 페이지와 일치시킬 수 있습니다.
제품 가격 및 재고를 업데이트하는 또 다른 방법은 상품 자동 업데이트를 사용하는 것입니다. 이는 API 업데이트와 함께 사용하여 판매자 센터의 정보와 제품 방문 페이지의 정보 간 불일치를 방지하는 데 도움이 됩니다. 하지만 이 기능은 제품 가격 및 재고 정확성과 관련된 작은 문제를 해결하도록 설계되었으므로 API를 통해 올바른 정보를 제공하는 것을 대체하지는 않습니다.
갱신 토큰을 사용해야 하는 경우
갱신 토큰은 승인 요청의 HTTP 헤더에 반환됩니다. 여기에는 다른 인증 관련 정보가 많이 포함되어 있지만, 액세스 토큰은 만료되기까지 60분밖에 지속되지 않으므로 개발자는 사용자의 인증을 반복적으로 요청할 필요가 없도록 갱신 토큰을 얻고 싶어하는 경우가 많습니다.