API 통합 및 Code Assist Toolkit

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 통합 및 Code Assist 툴킷을 사용하여 선호하는 워크플로에 맞게 설정을 맞춤설정하세요.

• 직접 컨텍스트 검색을 위한 {101
• 워크플로 기반 안내를 위한 Merchant API 에이전트 스킬

다음 다이어그램은 Antigravity, Visual Studio Code, Cursor, Copilot과 같이 가장 일반적으로 사용되는 통합 개발 환경(IDE)에서 AI 지원 코드 이전을 위한 설정 옵션을 보여줍니다. Gemini, Claude, ChatGPT, Grok과 같은 코딩 어시스턴트를 설정하고 Merchant API 개발자 문서 MCP 서버 또는 Merchant API 에이전트 스킬을 사용하여 통합 속도를 높이는 동시에 더 많은 정보를 제공할 수 있습니다.

참고: Merchant API 서비스 약관이 이 서비스에 적용됩니다. 이 서비스는 개발자 개인 정보 보호를 우선시하며 코딩 어시스턴트에서 실행한 쿼리를 기반으로 신뢰할 수 있는 공개적으로 사용 가능한 문서만 검색합니다. 사용하는 어시스턴트에 따라 서비스로 전송되는 쿼리가 결정됩니다. 권장사항으로 민감한 정보나 독점 정보를 전송하지 마세요.

Merchant API 개발자 문서 MCP 서버

선택한 코딩 어시스턴트에서 Merchant API에 관한 컨텍스트 인텔리전스를 가져옵니다. 이제 IDE 내에서 모델 컨텍스트 프로토콜 (MCP) 서비스를 사용하여 개발자 문서에 액세스할 수 있습니다. 이 서비스는 공식 Google API 문서의 주요 정보를 코딩 어시스턴트에 제공합니다. 프로토콜 자체에 관한 자세한 내용은 모델 컨텍스트 프로토콜 표준을 참고하세요.

작동 방식

MCP 지원 IDE 코딩 어시스턴트에게 Merchant API에 관한 질문을 하면 서비스는 공식 리소스에서 가장 관련성 높은 텍스트 및 코드 스니펫을 검색하고 특수 검색 증강 생성 (RAG) 백엔드를 사용하여 코딩 어시스턴트에 컨텍스트로 반환합니다. RAG 시스템은 LLM을 최신 외부 지식 소스에 연결하여 LLM의 응답 품질을 개선하는 시스템입니다. 이를 통해 개발 환경을 벗어나지 않고도 어시스턴트가 정확하고 최신 답변을 제공할 수 있습니다.

워크플로 예시:

1. MCP 호환 코딩 어시스턴트 또는 에이전트에서 질문합니다 (예: 자연어 질문, 코드 샘플 요청 또는 코드 번역).
2. 코딩 어시스턴트가 MCP 엔드포인트에 컨텍스트 요청을 전송합니다.
3. MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 모음을 검색합니다.
4. 서비스는 신뢰할 수 있는 스니펫을 코딩 어시스턴트에 컨텍스트로 반환합니다.
5. 코딩 어시스턴트는 이 컨텍스트를 활용하여 근거가 있는 답변 또는 코드 번역 작업을 생성합니다.

시작하기

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를 사용하여 코드를 직접 번역하도록 하려면 시스템 안내: 판매자 통합 에이전트 프로토콜을 제공하세요. 이러한 안내는 에이전트가 코드 번역을 위해 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 및 인벤토리 관련 필드만 포함하는 부분 제품 리소스를 제공할 수 있습니다.

'Merchant 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 서비스는 동시 요청을 위한 코드 리팩터링 에서 Merchant API에는 전용 custombatch 메서드가 없음을 설명하는 컨텍스트를 검색합니다. 대신 Content-Type이 multipart인 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 에이전트 스킬

에이전트 스킬 사양은 AI 개발 도구 전반에 채택된 개방형 표준입니다. 에이전트 스킬을 사용하여 개발자 환경을 개선하고 Content API for Shopping에서 이전하고 새로운 통합을 빌드하는 작업을 모두 최적화하세요. Merchant API 에이전트 스킬은 도메인별 지식과 도구를 패키징하여 AI 에이전트의 기능을 개선하고 문서 쿼리, 코드 생성, 문제 해결을 위한 주문형 전문가 지원을 제공합니다.

Merchant API 에이전트 스킬은 Gemini 및 Claude Code와 같은 다양한 AI 기반 명령줄 도구 및 IDE와 호환됩니다.

작동 방식

Merchant API 에이전트 스킬은 개방형 에이전트 스킬 표준을 기반으로 빌드된 전문 지식 패키지를 제공합니다. Google 에이전트 스킬 mapi-developer-assistant는 AI 개발 도구와 기본 Merchant API 개발 문서 MCP 서버 간의 지능형 레이어 역할을 합니다. 다음 속성을 가진 도메인 전문 지식과 절차 안내를 포함합니다.

• 구성 없음: MCP 서버 연결을 자동으로 관리하여 수동 엔드포인트 설정이 필요하지 않습니다.
• 전문가 워크플로: 사용자 프롬프트를 최적화된 쿼리로 세분화하여 가장 관련성 높은 정보를 효과적으로 가져옵니다.
• 컨텍스트 관리 및 토큰 효율성 : '점진적 공개'를 사용하여 주문형으로 정보를 로드하고 AI의 컨텍스트 창을 보존합니다.
• 향상된 출력 형식 지정: 실행 가능하고 읽기 쉬우며 일관된 응답을 위해 출력을 형식 지정하고 구조화하는 안내를 제공합니다.

워크플로 예시:

1. AI 개발 도구에서 Merchant API에 관한 질문을 합니다.
2. Merchant API 에이전트 스킬은 의도를 분석하고 정확한 쿼리를 공식화하며 절차적 지식을 요청에 적용합니다.
3. 에이전트 스킬은 merchantapi.googleapis.com/devdocs/mcp/에 있는 Merchant API 개발 문서 MCP 서버에 컨텍스트 요청을 전송합니다.
4. MCP 서비스는 색인이 생성된 공식 Merchant API 문서, 가이드, 코드 샘플 모음을 검색합니다.
5. AI 에이전트는 이 정보를 활용하여 종합적이고 실행 가능한 응답을 제공합니다.

시작하기

Merchant API 에이전트 스킬 README는 다음을 위한 단계별 안내를 제공합니다.

• Gemini 명령줄 도구와 같은 도구의 기본 요건
• 선택한 도구에서 에이전트 스킬 지원 사용 설정
• README에 따라 GitHub 저장소에서 mapi-developer-assistant 스킬 설치
• 설치 확인
• 기본 스킬 관리 명령어

Gemini 명령줄 도구, Claude Code 등 다양한 AI 도구의 자세한 설치 및 설정 안내는 README 파일의 안내를 따르세요.

프롬프트 예시

AI 개발 도구에 설치되고 사용 설정되면 일반적으로 Merchant API와 관련된 질문을 할 때 mapi-developer-assistant 스킬이 자동으로 활성화됩니다.

'Python에서 Merchant API를 사용하여 제품을 삽입하려면 어떻게 해야 하나요?'

'Content API accountstatuses.get 메서드에 상응하는 Merchant API는 무엇인가요?'

'Merchant API로 인증을 처리하는 Java 예를 보여줘'

" productInputs.insert를 호출할 때 유효성 검사 오류와 함께 '400 잘못된 요청'이 발생합니다. 이 문제를 해결하려면 어떻게 해야 하나요?'

"Merchant API에서 ProductInput과 Product의 차이점은 무엇인가요?"

기술 자료 소스

MCP 서비스는 제공하는 컨텍스트가 정확하고 신뢰할 수 있도록 공개 및 공식 소스에서만 기술 자료를 빌드합니다. 이 서비스는 다음을 비롯한 공식 개발자 사이트 및 코드 샘플 저장소의 전체 콘텐츠에 색인을 생성합니다.

• Merchant API 개발자 사이트: 모든 가이드, 참고 자료, 문서
• Merchant API Apps Script 서비스: Apps Script의 Merchant API 사용 예
• 공식 코드 샘플: GitHub 저장소의 Merchant API를 위한 모든 공식 Google 제공 코드 샘플
• 클라이언트 라이브러리: Merchant API에서 지원하는 모든 공식 클라이언트 라이브러리