권장사항

이 문서에서는 권장사항에 대한 가이드라인을 제공합니다. 자세한 내용은 성능 팁을 참고하세요.

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의 Datafeed 서비스를 사용하여 데이터 피드를 조작할 수 있습니다. 이렇게 하면 대규모 데이터 피드를 훨씬 쉽게 관리할 수 있지만 예기치 않은 결과가 발생할 수 있으므로 피드와 동시에 API를 사용하여 제품을 삽입하거나 업데이트하면 안 됩니다.

피드와 API를 함께 사용할 수 있는 다른 방법은 다음과 같습니다.

  • API에서 읽기 전용 요청 (가져오기 또는 나열) 실행: 일부 판매자는 API를 사용하여 제품의 정보와 상태 업데이트를 가져오려고 합니다. 제품 정보는 피드를 통해서만 업데이트되기 때문에 허용됩니다.

  • API를 사용하여 하위 계정 (계정 서비스) 또는 계정 수준 세금 및 배송 설정 (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를 값으로 사용하여 개별 상품을 포함할 수 있으며, 상품은 쇼핑 광고에 표시됩니다.

includedDestinationsexcludedDestinations 제품 속성에 관한 자세한 내용은 고객센터를 참고하세요.

만료되기 전에 상품을 업데이트하세요.

만료되기 전에 항목이 변경되지 않으면(최종 업데이트로부터 30일 후 또는 지정된 만료일(더 이른 경우))에도 항목이 변경되지 않으면 비활성화되지 않도록 항목을 업데이트하세요. 항목이 변경되지 않았거나 마지막으로 업데이트된 시간을 추적할 수 없어 여러 항목을 업데이트해야 하는 경우 모든 항목을 동시에 업데이트하지 말고 여러 날에 걸쳐 부하를 고르게 분산하세요.

Content API 피드를 삭제하지 마세요. 삭제 시 제품이 사라질 수 있습니다.

Content API를 통해 channel:online를 사용하여 제품을 처음 업로드하면 판매자 센터에 Content API라는 새 피드가 표시됩니다. Content API를 통해 channel:local를 사용하여 제품을 처음 업로드하면 판매자 센터에 Content API라는 제목의 새 피드가 오프라인 제품이라는 부제목과 함께 표시됩니다. 온라인 또는 로컬 Content API 피드를 실수로 삭제하지 않도록 하세요. 삭제하는 피드에 따라 Content API를 통해 판매자 센터에 추가한 온라인 또는 오프라인 제품이 삭제됩니다.

custombatch 메서드를 사용하여 동일한 서비스에 여러 요청 일괄 처리

동일한 서비스에 순차 또는 병렬 요청을 여러 개 실행하는 대신 원하는 모든 요청이 포함된 단일 커스텀 일괄 요청을 만드세요. 이렇게 하면 API 엔드포인트에 요청할 때 지연 시간이 각 개별 요청이 아닌 커스텀 일괄 호출에 대해 한 번만 발생하며 이는 순차적 요청을 하는 경우 특히 중요합니다.

한 번에 하나의 항목에 여러 업데이트를 전송하지 않음

이렇게 하면 업데이트 시퀀스에 관한 불확실성으로 인해 예기치 않은 결과가 발생하고 충돌 오류가 발생할 수 있습니다.

변경되지 않은 상품에 대한 업데이트 전송 안함

상품이 만료되지 않는 한 신규, 변경 또는 삭제된 제품 항목에 대한 요청만 전송해야 합니다.

가격이나 재고가 급변하는 경우 보조 피드 사용

제품의 가격, 재고, 판매 정보를 최신 상태로 유지하는 데 문제가 있다면 products 리소스의 보조 피드를 사용하여 이러한 속성의 업데이트만 전송해 보세요. 보조 피드 업데이트는 작기 때문에 특정 기간 동안 전체 제품 업데이트보다 더 많은 보조 피드 업데이트를 수행할 수 있으므로 제품 가격과 재고를 방문 페이지와 일치하도록 유지하는 데 도움이 됩니다.

제품 가격 및 재고를 업데이트하는 또 다른 방법은 상품 자동 업데이트를 사용하는 것입니다. 이 정보를 API 업데이트와 함께 사용하여 판매자 센터의 정보와 제품 방문 페이지의 정보가 일치하지 않도록 할 수 있습니다. 하지만 이는 제품 가격 및 재고 정확성과 관련된 사소한 문제를 해결하기 위해 설계되었으므로 자동 상품 업데이트가 API를 통해 올바른 정보를 제공하는 것을 대체하지는 않습니다.

갱신 토큰을 사용해야 하는 경우

갱신 토큰은 승인 요청의 HTTP 헤더에서 반환됩니다. 인증과 관련된 다른 정보가 많이 포함되어 있지만, 액세스 토큰이 만료되기 전 60분밖에 남지 않기 때문에 갱신 토큰은 사용자에게 인증을 요청하는 메시지를 반복적으로 표시할 필요가 없기 때문에 개발자가 직접 확인하고자 하는 경우가 많습니다.