Merchant API MCP Access Service (Alfa)

Yeni ajan tabanlı deneyimler ve otomatik iş akışları oluşturmak için Merchant Center verilerinize ve detaylı bilgilerinize yetkili erişim elde etmek üzere Merchant API Model Bağlam Protokolü (MCP) Access Service'i kullanın.

Genel Bakış

Merchant API MCP Access Service, LLM'ler, aracılar ve kodlama yardımcılarının Merchant Center verilerine dayalı yeni aracı tabanlı deneyimler ve otomatik iş akışları oluşturup düzenlemesi için standartlaştırılmış ve güvenli bir köprü sağlar.

Bu özellik, özellikle aşağıdaki gibi kullanım alanlarına yönelik salt okunur ve sınırlı yazma işlemleri gerçekleştirmek için Merchant Center verilerinize ve Google tarafından oluşturulan raporlara ve analizlere yetkili erişim sağlar:

  • Ürün retlerini teşhis etme ve düzeltme
  • Performans raporları ve analizleri oluşturma
  • Otomatik iyileştirmeleri etkinleştirme seçeneğini inceleyin
  • Veri kaynakları oluşturma ve getirme

Güvenlik ve erişim denetimleri

Merchant API MCP Access Service, güvenlik önceliğiyle tasarlanmıştır:

  • Kimlik doğrulama: Araç yürütme işlemi, standart Merchant API kimlik doğrulaması ile yönetilir ve OAuth 2.0 veya hizmet hesabı kimlik bilgilerini gerektirir. Mümkün olan en kısıtlayıcı erişim haklarına sahip kimlik bilgilerini kullanmanızı öneririz.
  • Yürütme Güvenliği: Araç görünürlüğü, bağımsız keşif için kısıtlanmamış olsa da araç yürütme, belirli API kimlik bilgilerinizle sınırlıdır.
  • Koruma önlemleri: Araçlar, güvenlik önlemi olarak yalnızca okuma işlemleri ve düşük riskli yazma araçlarıyla (ör. veri kaynağı oluşturma) sınırlıdır.

Dikkat edilecek önemli noktalar

Merchant API MCP Access Service, alfa sürümündedir. Kapsamı ve özellikleri genişletilecek ve değişebilir.

Başlamadan önce aşağıdaki sınırlamaları ve en iyi uygulamaları inceleyin:

Değişiklikler ve yayınlar

Değişiklikler önceden bildirimde bulunmaksızın yapılabilir ve sürüm notlarında yayınlanır.

Güvenli test

Bu araçları canlı üretim ortamında kullanmadan önce test hesabı veya canlı olmayan bir hesapla deneme yapmanızı öneririz.

Paylaşılan kota

Merchant API MCP Access Service, standart Merchant API çağrılarınızla aynı kota havuzunu paylaşır. Çalışan aracıların kotası, özellikle veri kaynağı getirme işlemleri için hızla tükenebilir. Üretim hizmetinde kesintileri önlemek için test hesabı kullanmanızı önemle tavsiye ederiz.

Araç filtreleme ve güvenlik

Gelecekte özellikle yazma işlemleriyle ilgili yeni özellikler eklenecektir. Tüm araç setini kullanıma sunmak yerine istemcinizi yerleşik araç filtrelemeyi kullanacak şekilde açıkça yapılandırmanızı önemle tavsiye ederiz.

Kullanılabilir özelliklerin özeti

Merchant API MCP Access Service'i kullanarak aşağıdaki işlemleri ajan tabanlı bir şekilde gerçekleştirebilirsiniz:

  • Tam kaynak adlarını kullanarak belirli ürünler için ayrıntılı durum ve raporlama bağlamını alma
  • Birden fazla ürün için listeleme oluşturun ve arama yapın.
  • Sorgu performans metrikleri, ürün durumları ve popüler ürünler, fiyat analizleri, görünürlük rekabeti ve YouTube Alışveriş satış ortağı analizleriyle ilgili analizler.
  • Ürün görünürlüğünü veya programa katılımı etkileyen hesap düzeyindeki sorunları belirleyin.
  • Veri kaynaklarının yükleme durumunu listeleme, oluşturma, getirme ve kontrol etme
  • Envanterinizdeki ürünlerin onaylanmamasının toplu nedenlerini listeleyin.
  • Öğeler, resimler ve kargo için otomatik iyileştirme ayarlarını inceleyin.
  • Belirli Merchant Center programları için etkin bölgeleri, karşılanmayan koşulları ve katılım durumunu kontrol edin.

Başlarken

IDE'nizi, kodlama asistanınızı veya aracınızı Merchant API MCP Access Service'e bağlamak için MCP istemci ayarlarınızı (ör. mcp.json veya settings.json) güncelleyin.

İstemci yapılandırması

Yapılandırma kurulumları:

Antigravity

OAuth 2.0 erişim jetonu (https://www.googleapis.com/auth/content kapsamıyla) kullanarak doğrudan barındırılan uzak MCP uç noktasına bağlanın. Antigravity belgelerindeki talimatları uygulayın.

{
    "mcpServers": {
        "merchant-api-access": {
            "serverUrl": "https://merchantapi.googleapis.com/mcp",
            "headers": {
                "Authorization": "Bearer {ACCESS_TOKEN}",
                "x-goog-user-project": "{GOOGLE_CLOUD_PROJECT_ID}"
            }
        }
    }
}

Claude CLI

Barındırılan uzak MCP uç noktasını doğrudan Claude CLI'ye claude mcp add komutunu kullanarak ekleyin:

claude mcp add --transport http merchant-api https://merchantapi.googleapis.com/mcp --scope local \
  --header "Authorization: Bearer {ACCESS_TOKEN}" \
  --header "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}"

Claude MCP dokümanlarındaki talimatları uygulayın.

cURL

Barındırılan Merchant API MCP uç noktasına doğrudan standart JSON-RPC 2.0 istekleri gönderin.

Kullanılabilir araçları listeleme:

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

Araç çağrısı yürütme (örneğin, list_data_sources):

curl -s -X POST "https://merchantapi.googleapis.com/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "X-Goog-User-Project: {GOOGLE_CLOUD_PROJECT_ID}" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      }
    }
  }'

Aşağıdakini değiştirin:

  • ACCOUNT_ID: Merchant Center kimliğiniz
  • ACCESS_TOKEN: API çağrısı yapmak için kullanılan yetkilendirme jetonu
  • GOOGLE_CLOUD_PROJECT_ID: Merchant Center hesabınızla ilişkili Google Cloud projesinin kimliği

Örnek kullanım senaryoları

Temsilci tabanlı deneyimler ve otomatik iş akışları oluşturmak için Merchant API MCP Access Service'ten nasıl yararlanabileceğinizi göstermek amacıyla aşağıdaki senaryoları inceleyin:

1. senaryo: Ürün retlerini teşhis etme ve düzeltme

Belirli bir ürünün Google arama sonuçlarında neden gösterilmediğini anlamak istiyorsunuz.

Kullanıcı istemi:

"Teklif numarası "offer123" olan ürünüm neden onaylanmadı?"

MCP ile aracı davranışı:

  1. Temsilci, ürün durumunu bulmak için list_products veya get_product_by_name numaralı telefonu arar.
  2. MCP sunucusu, issues listesi de dahil olmak üzere ürün durumunu döndürür (örneğin, "Yanlış fiyat biçimi" veya "Eksik kargo değeri").
  3. Ajan, sorunları analiz eder ve temel nedeni size açıklayarak nasıl düzeltileceğini (ör. fiyat bilgilerini güncelleme) önerir.

2. senaryo: Otomatik iyileştirmeleri etkinleştirme seçeneğini inceleme

Otomatik kargo iyileştirmelerinizin etkin olup olmadığını doğrulamak istiyorsanız.

Kullanıcı istemi:

"Otomatik kargo iyileştirmelerim etkin mi?"

MCP ile aracı davranışı:

  1. Aracı, hesap düzeyindeki ayarları almak için get_automatic_improvements işlevini çağırır.
  2. MCP sunucusu, resim, öğe ve kargo iyileştirmelerinin durumunu gösteren yapılandırmayı döndürür.
  3. Ajan, kargo iyileştirmelerinin etkin olduğunu onaylar veya devre dışıysa nasıl etkinleştirileceğini açıklar.

3. senaryo: Performans raporları ve analizleri oluşturma

Merchant Center kullanıcı arayüzünde gezinmeden son performansınızı hızlıca kontrol etmek istiyorsunuz.

Kullanıcı istemi:

"Geçen hafta tıklama sayısına göre en iyi performansı gösteren 5 ürünümü göster."

MCP ile aracı davranışı:

  1. Ajan, product_performance_view tablosunu hedefleyen, clicks DESC ile sıralayan ve 5 ile sınırlayan bir Merchant Center Sorgu Dili (MCQL) sorgusu oluşturur.
  2. Ajan, oluşturulan sorguyla report_search işlevini çağırır.
  3. MCP sunucusu, sorguyu canlı raporlama veritabanında yürütür ve satırları döndürür.
  4. Temsilci, sonuçları sizin için temiz bir Markdown tablosu olarak biçimlendirir.

4. senaryo: Veri kaynakları oluşturma ve getirme

Ürün güncellemelerini yüklemek için yeni bir veri kaynağı eklemek istiyorsunuz.

Kullanıcı istemi:

"Satıcı hesabım için "price-updates" adlı bir ek veri kaynağı oluştur."

MCP ile aracı davranışı:

  1. Temsilci, yeni özet akışını kaydetmek için belirtilen ayarlarla create_data_source çağrısı yapar.
  2. MCP sunucusu, veri kaynağını oluşturur ve benzersiz kaynak adını döndürür.
  3. Ajan, indirme ve ilişkili dosyanın işlenmesini tetiklemek için fetch_data_source işlevini çağırır.
  4. Yükleme ilerleme durumunu izlemek ve öğelerin başarılı bir şekilde işlendiğini onaylamak için aracı get_file_upload çağrıları yapar.

MCP araçları ve açıklamaları

Merchant API MCP Access Service, aracınız için aşağıdaki araçları kullanıma sunar:

MCP Aracı Açıklama
get_product_by_name Tam ürün kaynağı adını kullanarak belirli bir satıcıya ait ürün bilgilerini alın. Raporlama bağlamını ve olası ürün düzeyindeki sorunları içeren ayrıntılı ürün durumunu döndürür.
list_products Belirli bir satıcı için birden fazla ürünü listeleyin veya arayın. Birden fazla ürün için raporlama bağlamını ve olası ürün düzeyindeki sorunları içeren ayrıntılı ürün durumunu döndürür.
report_search Ürün performansı metriklerini, ürün durumlarını, fiyat analizlerini ve görünürlük rekabetini almak için sorgu raporlama tablolarını kullanın. Ayrıntılar için Raporlar kılavuzuna bakın.
list_data_sources Belirli bir satıcı için kullanılabilen veri kaynaklarını listeler.
get_data_source Belirli bir veri kaynağının ayrıntılarını alma
create_data_source Belirli bir satıcı için yeni bir veri kaynağı oluşturun.
fetch_data_source Belirli bir satıcı için veri kaynağıyla ilişkili dosyayı getirme ve işleme
get_file_upload Belirli bir veri kaynağı için en son dosya yükleme işleminin durumunu alın.
list_accounts Belirli bir kullanıcıya ait hesapları listeler.
list_account_issues Hesap genelindeki sorunları belirlemek için belirli bir satıcıyla ilgili hesap düzeyindeki sorunları listeleyin.
list_programs Katılım durumu, etkin bölgeler ve karşılanmayan koşullar da dahil olmak üzere belirli bir satıcıya ait programları listeler.
list_aggregate_product_statuses Ürün verilerinizin genel durumunu izlemek için ürün düzeyindeki sorunları toplu olarak listeleyin.
get_automatic_improvements Öğe güncellemeleri, resim iyileştirmeleri ve kargo iyileştirmeleri gibi otomatik iyileştirme ayarlarını kullanın.