API 통합 및 Code Assist 툴킷을 사용하여 Merchant API로의 이전을 가속화하고 AI 기반 개발 도구로 새로운 통합을 빌드하세요.
개요
Content API for Shopping에서 Merchant API로 이전하거나 새로운 통합을 빌드할 때는 새로운 서비스 구조, 리소스 이름, 메서드를 이해해야 합니다. AI 기반 개발 도구는 특히 다음 작업을 지원하는 데 적합합니다.
- 코드 변환 및 이전: 기존 Content API for Shopping 코드를 새로운 Merchant API 형식으로 이해하고 변환하는 데 도움이 됩니다. 여기에는 제품 속성을 새 구조에 매핑하고 종속 항목 관리 파일을 업데이트하는 작업이 포함됩니다.
- API 문서 전문성: 공식 Google API 문서의 공신력 있는 컨텍스트를 기반으로 Merchant API 리소스, 메서드, 필드, 할당량, 권장사항을 명확하게 설명합니다.
- 코드 생성: Python, Java, PHP 등의 언어로 다양한 Merchant API 작업을 위한 코드 스니펫을 생성합니다.
- 문제 해결: 일반적인 API 오류를 진단하고 해결하는 데 도움을 줍니다.
개발 환경과 특정 사용 사례에 가장 적합한 옵션을 선택하세요. API 통합 및 코드 어시스턴트 툴킷을 사용하여 원하는 워크플로에 맞게 설정을 조정합니다.
- 직접 컨텍스트 검색을 위한 Merchant API 개발자 문서 MCP 서버
- 워크플로 기반 안내를 위한 Merchant API 상담사 기술
다음 다이어그램은 Antigravity, Visual Studio Code, Cursor, Copilot과 같은 가장 일반적으로 사용되는 통합 개발 환경(IDE)에서 AI 지원 코드 이전의 설정 옵션을 보여줍니다. Gemini, Claude, ChatGPT, Grok과 같은 코딩 어시스턴트를 설정하고 Merchant API 개발자 문서 MCP 서버 또는 Merchant API 에이전트 기술을 사용하여 통합 속도를 높이는 동시에 더 많은 정보를 제공할 수 있습니다.
Merchant API 개발자 문서 MCP 서버
선택한 코딩 어시스턴트에서 판매자 API에 관한 컨텍스트 기반 인텔리전스를 확인하세요. 이제 IDE 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 개발자 문서에 액세스할 수 있습니다. 이 서비스는 공식 Google API 문서에서 코딩 어시스턴트 주요 정보를 제공합니다. 프로토콜 자체에 대한 자세한 내용은 모델 컨텍스트 프로토콜 표준을 참고하세요.
작동 방식
MCP 지원 IDE 코딩 어시스턴트에게 Merchant API에 관한 질문을 하면 서비스가 공식 리소스에서 가장 관련성 높은 텍스트와 코드 스니펫을 가져와 특화된 검색 증강 생성 (RAG) 백엔드를 사용하여 코딩 어시스턴트에게 컨텍스트로 반환합니다. RAG 시스템은 LLM을 최신 외부 지식 소스에 연결하여 LLM의 응답 품질을 개선하는 시스템입니다. 이를 통해 개발 환경을 벗어나지 않고도 어시스턴트가 정확하고 최신 답변을 제공할 수 있습니다.
워크플로 예:
- MCP 호환 코딩 어시스턴트 또는 에이전트 (예: 자연어 질문, 코드 샘플 요청, 코드 번역)에 질문합니다.
- 코딩 어시스턴트가 컨텍스트 요청을 MCP 엔드포인트로 전송합니다.
- MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 모음을 검색합니다.
- 서비스는 공신력 있는 스니펫을 코딩 어시스턴트의 컨텍스트로 반환합니다.
- 코딩 어시스턴트는 이 컨텍스트를 활용하여 그라운딩된 답변이나 코드 변환 작업을 생성합니다.
시작하기
MCP를 통합하고 사용하려면 다음 단계를 따르세요.
1. 호환되는 도구 사용
스트리밍 가능한 HTTP 전송을 사용하여 모델 컨텍스트 프로토콜을 지원하는 IDE 또는 코딩 어시스턴트를 엽니다.
2. 엔드포인트 구성
IDE 또는 코딩 어시스턴트를 MCP에 연결하려면 제공된 원격 엔드포인트 세부정보를 사용하세요. 도구의 구성에 따라 직접 서비스 URL 또는 MCP 정의를 입력해야 할 수 있습니다.
구성 설정:
Antigravity
Antigravity 문서의 안내를 따르세요.
"mcpServers": {
"mapi-devdocs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://merchantapi.googleapis.com/devdocs/mcp"
]
}
}
Visual Studio Code
Visual Studio Code 문서의 안내를 따릅니다.
"servers": {
"mapi-devdocs": {
"type": "http",
"url": "https://merchantapi.googleapis.com/devdocs/mcp/"
}
}
3. 에이전트 안내 추가 (선택사항)
에이전트가 MCP를 사용하여 코드를 직접 번역할 수 있도록 하려면 시스템 요청 사항: Merchant Integrator Agent Protocol을 제공하세요. 이 안내는 상담사에게 코드 번역을 위해 MCP를 올바르게 활용하는 방법을 안내합니다. 도구에 따라 시스템 안내 구성에서 또는 에이전트의 추가 컨텍스트 파일로 이러한 안내를 제공할 수 있습니다.
사용 시나리오 예시
MCP는 다음과 같은 일반적인 사용 사례에서 워크플로를 가속화할 수 있습니다.
시나리오 1: products.insert 코드 마이그레이션
에이전트에게 Content API for Shopping products.insert 통합 코드를 Merchant API로 직접 이전해 달라고 요청할 수 있습니다.
사용자 프롬프트:
'
products.insert코드를 Merchant API로 이전'
에이전트에게 시스템 지침과 MCP 액세스 권한을 제공하면 에이전트가 IDE에서 Content API for Shopping 코드를 Merchant API 코드로 직접 변환할 수 있습니다. 이 경우 productInputs.insert을 동등한 호출로 식별하고 이전 형식의 제품 속성을 Merchant API에 필요한 새 형식으로 매핑합니다. 필수 가져오기 및 종속 항목 관리 파일 (예: requirements.txt, pom.xml, package.json)도 업데이트할 수 있습니다. 에이전트에게 변경사항을 적용하거나 새 폴더를 만들도록 지시할 수 있습니다.
시나리오 2: 동등한 기능 찾기
Content API for Shopping을 사용하는 기존 애플리케이션이 있으며 이를 업데이트해야 합니다. 특정 기존 메서드에 관해 질문하여 새 구현과 관련 코드 샘플에 관한 세부정보를 확인할 수 있습니다.
사용자 프롬프트:
'Content API for Shopping의 accountstatuses.get 메서드에 해당하는 Merchant API는 무엇인가요?'
MCP 서비스는 공식 이전 가이드와 참조 문서의 컨텍스트를 제공하므로 어시스턴트가 새 API 이름인 accounts.issues를 포함한 자세한 답변을 제공할 수 있습니다.
시나리오 3: 코드 샘플 찾기
새 기능을 구현하고 있으며 따라야 할 실제 예가 필요합니다.
사용자 프롬프트:
'Merchant API를 사용하여 새 배송 서비스를 추가하는 Python 코드 샘플을 보여 줘.'
MCP 서비스는 공식 Google GitHub 저장소 및 개발자 가이드에서 관련 코드 샘플을 가져옵니다. 그러면 어시스턴트가 적응 가능한 완전한 코드 블록을 표시할 수 있습니다.
시나리오 4: API 개념 이해
새로운 개념을 접하거나 리소스의 구조 또는 전체 Merchant API 패턴을 이해하고 싶습니다.
사용자 프롬프트:
'Merchant API를 사용하여 제품의 인벤토리를 업데이트하려면 어떻게 해야 하나요?'
MCP 서비스는 제품 리소스 문서와 관련 가이드에서 컨텍스트를 반환합니다. 그러면 어시스턴트가 accounts.productInputs.insert 메서드 사용 방법을 설명하고 업데이트해야 하는 productId 및 인벤토리 관련 필드만 포함된 부분 제품 리소스를 제공할 수 있습니다.
'판매자 API로 애플리케이션 호출을 승인하려면 어떻게 해야 하나요?'
MCP 서비스는 다양한 승인 방법을 다루는 공식 인증 가이드에서 컨텍스트를 가져옵니다. 그러면 어시스턴트가 서버 간 상호작용에 서비스 계정을 사용하거나 사용자를 대신하여 작업할 때 OAuth 2.0 클라이언트 ID를 사용하는 등 사용 가능한 기본 옵션을 설명할 수 있습니다.
시나리오 5: API 변경사항에 적응
Merchant API에는 Content API for Shopping과 다른 요청 일괄 처리와 같은 새로운 패턴이 도입되었습니다. Content API for Shopping은 특정 custombatch 메서드를 사용하는 반면 Merchant API는 내장된 일반 HTTP 일괄 처리 기능을 사용합니다.
사용자 프롬프트:
'Merchant API에서 products.custombatch를 실행하는 새로운 방법은 무엇인가요?'
MCP 서비스는 동시 요청을 위한 코드 리팩터링에서 컨텍스트를 가져와 전용 custombatch 메서드가 Merchant API에 없다고 설명합니다.
대신 multipart의 Content-Type를 사용하여 HTTP 일괄 처리를 사용하는 방법에 관한 문서를 제공합니다. 그러면 어시스턴트가 https://merchantapi.googleapis.com/batch/{sub-api}/v1 엔드포인트로 전송되는 여러 API 호출이 포함된 단일 HTTP 요청을 구성하는 방법을 설명하고 멀티파트 요청을 구조화하는 방법을 예로 보여줄 수 있습니다. 이렇게 하면 혼동을 일으킬 수 있는 마이그레이션 작업이 안내 프로세스로 바뀝니다.
시나리오 6: 보고 쿼리 번역
Content API for Shopping의 보고 쿼리를 Merchant API로 번역해 달라고 에이전트에게 요청할 수 있습니다.
사용자 프롬프트:
'이 보고 쿼리를 Content API에서 Merchant API로 이전해 줘. SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30''
MCP 서비스는 최신 보고 참조 문서, 개발자 가이드, 이전 가이드를 가져옵니다. 이 정보를 기반으로 쿼리를 새 구조로 변환하고 필드를 새 이름과 값으로 업데이트합니다.
Merchant API Agent Skills
Agent Skills 사양은 AI 개발 도구 전반에서 채택된 개방형 표준입니다. 에이전트 기술을 사용하여 개발자 환경을 개선하고 쇼핑 콘텐츠 API에서 이전하고 새로운 통합을 빌드하는 두 가지 모두 최적화하세요. Merchant API Agent Skills는 도메인별 지식과 도구를 패키징하여 AI 에이전트의 기능을 개선하고 문서 쿼리, 코드 생성, 문제 해결을 위한 주문형 전문가 지원을 제공합니다.
Merchant API Agent Skills는 Gemini, Claude Code와 같은 다양한 AI 기반 명령줄 도구 및 IDE와 호환됩니다.
작동 방식
Merchant API 에이전트 스킬은 개방형 에이전트 스킬 표준을 기반으로 빌드된 전문 지식 패키지를 제공합니다. Google의 에이전트 스킬 mapi-developer-assistant은 AI 개발 도구와 기본 Merchant API 개발 문서 MCP 서버 간의 지능형 레이어 역할을 합니다. 도메인 전문 지식과 절차적 안내를 포함하며 다음과 같은 속성이 있습니다.
- 무구성: MCP 서버 연결을 자동으로 관리하여 엔드포인트를 수동으로 설정할 필요가 없습니다.
- 전문가 워크플로: 사용자 프롬프트를 최적화된 쿼리로 개선하여 가장 관련성 높은 정보를 효과적으로 가져옵니다.
- 컨텍스트 관리 및 토큰 효율성: '점진적 공개'를 사용하여 필요에 따라 정보를 로드하고 AI의 컨텍스트 윈도우를 보존합니다.
- 향상된 출력 형식: 실행 가능하고 읽기 쉬우며 일관된 대답을 위해 출력을 형식화하고 구조화하는 방법을 안내합니다.
워크플로 예:
- AI 개발 도구에서 Merchant API에 관해 질문합니다.
- Merchant API Agent Skill은 의도를 분석하고 정확한 질문을 구성하며 절차적 지식을 요청에 적용합니다.
- 에이전트 스킬은
merchantapi.googleapis.com/devdocs/mcp/에 있는 Merchant API Dev Doc MCP 서버에 컨텍스트를 요청합니다. - MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 모음을 검색합니다.
- AI 에이전트는 이 정보를 활용하여 종합적이고 실행 가능한 대답을 제공합니다.
시작하기
Merchant API Agent Skills README에서는 다음 사항에 관한 단계별 안내를 제공합니다.
- Gemini 명령줄 도구와 같은 도구의 필수 구성요소
- 선택한 도구에서 에이전트 스킬 지원을 사용 설정합니다.
- README에 따라 GitHub 저장소에서
mapi-developer-assistant스킬을 설치합니다. - 설치를 확인합니다.
- 기본 기술 관리 명령어입니다.
Gemini 명령줄 도구, Claude Code 등 다양한 AI 도구의 자세한 설치 및 설정 안내는 README 파일의 안내를 따르세요.
프롬프트 예시
AI 개발 도구에 설치되고 사용 설정되면 mapi-developer-assistant 스킬은 일반적으로 판매자 API와 관련된 질문을 할 때 자동으로 활성화됩니다.
'Python에서 Merchant API를 사용하여 제품을 삽입하려면 어떻게 해야 하나요?'
'Content API
accountstatuses.get메서드에 해당하는 Merchant API는 무엇인가요?'
'Merchant API를 사용한 인증을 처리하는 Java 예시를 보여 줘.'
'
productInputs.insert를 호출할 때 검증 오류와 함께 '400 잘못된 요청'이 표시됩니다. 이 문제를 해결하려면 어떻게 해야 하나요?'
'판매자 API에서
ProductInput와Product의 차이점은 무엇인가요?'
기술 자료 소스
MCP 서비스는 제공하는 컨텍스트가 정확하고 신뢰할 수 있도록 공개 및 공식 소스에서만 지식 베이스를 구축합니다. 이 서비스는 다음을 비롯한 공식 개발자 사이트와 코드 샘플 저장소의 전체 콘텐츠를 색인합니다.
- Merchant API 개발자 사이트: 모든 가이드, 참고 자료, 문서
- Merchant API Apps Script 서비스: Apps Script에서 Merchant API를 사용하는 예입니다.
- 공식 코드 샘플: GitHub 저장소의 Merchant API에 대해 Google에서 제공하는 모든 공식 코드 샘플입니다.
- 클라이언트 라이브러리: Merchant API에서 지원하는 모든 공식 클라이언트 라이브러리입니다.