이 문서에서는 권장사항에 관한 가이드라인을 제공합니다. 자세한 내용은 성능 도움말을 참고하세요.
API를 사용해야 하는 경우
프로그래매틱 방식으로 요청 보내기
워크플로의 모든 부분을 자동화하거나 ERP (Enterprise Resource Planning) 시스템에 후크를 만들려는 경우 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를 사용하여 하위 계정 (Accounts 서비스) 또는 계정 수준 세금 및 배송 설정 (Accounttax 서비스 및 Shippingsettings 서비스)을 관리합니다. 이는 데이터 피드에서 제공할 수 있는 함수가 아니므로 API를 사용하여 이러한 함수를 관리하는 것과 충돌하지 않습니다.
데이터 피드 사용에서 API 전용으로 이전하거나 그 반대로 이전하려면 어떻게 해야 하나요?
현재 데이터 피드를 사용 중이며 제품 업데이트에 API만 사용하도록 전환하려면 API를 사용하여 제품 데이터를 다시 업로드해야 합니다. 제품 서비스를 사용하여 특정 제품을 업데이트하면 API가 제품 정보를 제어하며, 데이터 피드에서 제품을 삭제하거나 데이터 피드 자체를 삭제해도 더 이상 판매자 센터 계정에서 제품 정보가 삭제되지 않습니다. 데이터 피드 또는 데이터 피드 자체에서 제품을 삭제하려면 데이터 피드 업데이트가 없어야 합니다. 그러지 않으면 데이터 피드에서 소유권을 다시 가져오고 데이터 피드에서 제품을 삭제하면 제품이 삭제됩니다.
현재 제품 정보에 API만 사용하고 데이터 피드를 제품 정보의 기본 소스로 사용하려면 판매자 센터 계정에 새 데이터 피드를 추가하기만 하면 됩니다. 그러면 등록된 제품의 소유권이 이전됩니다. API에서만 업로드된 제품 중 만료되기 전에 삭제하려는 제품이 있는 경우 판매자 센터 또는 API를 통해 삭제해야 합니다.
Content API for Shopping을 사용하여 제품으로 여러 국가를 타겟팅하려면 어떻게 해야 하나요?
Content API를 통해 제출된 제품의 광고 및 무료 등록정보로 여러 국가를 타겟팅하려면 판매자 센터의 Content API 기본 피드에서 국가를 추가로 구성하거나 products 리소스의 shipping 필드를 통해 추가 국가를 추가합니다.
Content API 기본 피드 설정을 수정하는 방법의 예는 다음과 같습니다.
자세한 내용은 여러 국가에서 쇼핑 광고 및 무료 등록정보 타겟팅을 참고하세요.
클라이언트 라이브러리가 최신 상태인지 확인
Google 클라이언트 라이브러리를 사용하여 Content API와 상호작용하는 경우 선택한 프로그래밍 언어의 패키지 관리자를 사용하고 라이브러리 버전이 최신 버전인지 확인하세요. 자세한 내용은 샘플 및 라이브러리에서 선택한 언어의 개발자 가이드를 참고하세요.
대상 유형 속성을 사용하여 다양한 쇼핑 프로그램에 표시할 제품을 관리해야 합니다.
Content API는 판매자 센터에서 구성된 Content API 피드의 기본 설정을 자동으로 채택합니다. includedDestinations 또는 excludedDestinations 제품 속성을 사용하여 피드 내에서 또는 Content API를 통해 제품 수준에서 프로그램 참여를 관리할 수 있습니다.
API 피드가 Buy on Google(이전 명칭: Shopping Actions)과 같은 프로그램에 선택되었지만 특정 제품을 제외하려면 excludedDestinations 속성을 사용하고 값으로 Shopping Actions를 지정합니다. 오류가 없으면 판매자 센터의 기본 피드 설정이 덮어쓰기되고 해당 상품이 Buy on 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 메서드를 사용하여 동일한 서비스에 대한 여러 요청 일괄 처리
동일한 서비스에 여러 번 순차적으로 또는 동시에 요청하는 대신 원하는 모든 요청이 포함된 단일 맞춤 일괄 요청을 실행합니다. 이렇게 하면 API 엔드포인트에 대한 요청 지연 시간이 각 개별 요청이 아닌 custombatch 호출에 대해 한 번만 발생하므로 순차적으로 요청하는 경우에 특히 중요합니다.
단일 일괄 처리에서 단일 항목에 여러 업데이트를 전송하지 않음
이렇게 하면 업데이트 순서에 대한 불확실성으로 인해 예기치 않은 결과가 나타나고 충돌 오류가 발생할 수 있습니다.
변경되지 않은 항목의 업데이트 전송 안 함
항목이 만료되지 않는 한 신규, 변경 또는 삭제된 제품 항목에 대한 요청만 전송해야 합니다.
가격 또는 재고가 빠르게 변경되는 경우 보충 피드 사용
제품의 가격, 재고 또는 할인 정보를 최신 상태로 유지하는 데 문제가 있는 경우 products 리소스의 보조 피드를 사용하여 이러한 속성의 업데이트만 전송해 보세요. 보조 피드 업데이트는 규모가 작기 때문에 특정 기간에 전체 제품 업데이트보다 더 많은 보조 피드 업데이트를 할 수 있습니다. 이렇게 하면 제품 가격과 재고가 방문 페이지와 일치하도록 유지할 수 있습니다.
제품 가격 및 재고를 업데이트하는 또 다른 방법은 상품 자동 업데이트를 사용하는 것입니다. 이는 API 업데이트와 함께 사용하여 판매자 센터의 정보와 제품 방문 페이지의 정보 간에 불일치가 발생하지 않도록 할 수 있습니다. 하지만 이 기능은 제품 가격 및 재고 정확성과 관련된 사소한 문제를 해결하기 위해 설계되었으므로 자동 상품 업데이트는 API를 통해 올바른 정보를 제공하는 것을 대체하지 않습니다.
갱신 토큰을 사용해야 하는 경우
갱신 토큰은 승인 요청의 HTTP 헤더에 반환됩니다. 여기에는 다른 많은 인증 관련 정보가 포함되어 있지만, 액세스 토큰은 만료되기까지 60분밖에 지속되지 않으므로 사용자에게 인증을 반복적으로 요청할 필요가 없으므로 개발자가 가장 관심을 갖는 부분은 새로고침 토큰입니다.