권장사항

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

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 서비스)을 관리합니다. 이는 Datafeed에서 제공할 수 있는 함수가 아니므로 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분밖에 걸리지 않기 때문입니다.