Merchant API MCP Access Service (Alfa)

Merchant Center verilerinize ve analizlerinize yetkili erişim elde etmek için Merchant API Model Context Protocol (MCP) Access Service'i kullanarak yeni temsilci tabanlı deneyimler ve otomatik iş akışları oluşturun.

Genel Bakış

Merchant API MCP Access Service; LLM'ler, temsilciler ve kodlama asistanları için Merchant Center verilerine dayalı yeni temsilci tabanlı deneyimler ve otomatik iş akışları oluşturup düzenlemek üzere standartlaştırılmış, güvenli bir köprü sağlar.

Özellikle, Merchant Center verilerinize ve Google tarafından oluşturulan raporlara ve analizlere yetkili erişim sağlayarak salt okunur ve sınırlı yazma işlemleri gerçekleştirmenize olanak tanır. Bu sayede aşağıdaki kullanım alanlarına yönelik çözümler üretebilirsiniz:

• Ürün retlerini teşhis etme ve düzeltme
• Performans raporları ve analizler 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üvenliğe öncelik verecek şekilde tasarlanmıştır:

• Kimlik doğrulama: Araç yürütme, standart Merchant API kimlik doğrulaması tarafından yönetilir. Bu işlem için OAuth 2.0 veya hizmet hesabı kimlik bilgileri gerekir. 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: Temsilci tabanlı keşif için araç görünürlüğü kısıtlanmaz ancak araç yürütme, belirli API kimlik bilgilerinizle kısıtlanır.
• Güvenlik önlemleri: Araçlar, güvenlik önlemi olarak salt okunur işlemler ve düşük riskli yazma araçlarıyla (ör. veri kaynağı oluşturma) kesinlikle sınırlıdır.

Dikkat edilecek önemli noktalar

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

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

Değişiklikler ve sürümler

Değişiklikler önceden bildirimde bulunulmadan 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 hesap kullanarak 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 temsilciler, özellikle veri kaynağı getirme işlemleri için kotayı hızla tüketebilir. Üretim hizmetinde kesinti yaşanmaması için test hesabı kullanmanızı önemle tavsiye ederiz.

Araç filtreleme ve güvenlik

Gelecekte, özellikle yazma işlemleri olmak üzere yeni özellikler eklenecektir. İstemcinizi, tüm araç setini göstermek yerine yerleşik araç filtreleme için 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 temsilci 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ü listeleme ve arama
• Performans metriklerini, ürün durumlarını ve popüler ürünlerle ilgili analizleri, fiyatlandırma analizlerini, görünürlük rekabetini ve YouTube Alışveriş satış ortağı analizlerini sorgulayın.
• Ü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 onaylanmama nedenlerini toplu olarak 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, kod yazma desteğinizi veya temsilcinizi 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 ayarları:

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

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}"

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/list" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

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}" \
  -H "MCP-Protocol-Version: {MCP_PROTOCOL_VERSION}" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: list_data_sources" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "list_data_sources",
      "arguments": {
        "parent": "accounts/{ACCOUNT_ID}"
      },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion":
          "{MCP_PROTOCOL_VERSION}"
      }
    }
  }'

Örnek kullanım senaryoları

Ajan 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 ürünlerin Google Arama sonuçlarında neden gösterilmediğini öğrenmek istiyorsunuz.

Kullanıcı istemi:

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

MCP ile temsilci davranışı:

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

2. senaryo: Otomatik iyileştirmeleri etkinleştirme durumunu inceleme

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

Kullanıcı istemi:

"Otomatik kargo iyileştirmelerim etkin mi?"

MCP ile temsilci davranışı:

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

3. senaryo: Performans raporları ve analizler 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 temsilci davranışı:

1. Temsilci, product_performance_view tablosunu hedefleyen, clicks DESC ölçütüne göre sıralayan ve 5 ile sınırlayan bir Merchant Center Sorgu Dili (MCQL) sorgusu oluşturur.
2. Temsilci, oluşturulan sorguyla report_search aracını ç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 istiyorsanız

Kullanıcı istemi:

"Satıcı hesabım için 'fiyat-güncellemeleri' adlı bir ek veri kaynağı oluştur."

MCP ile temsilci davranışı:

1. Temsilci, yeni feed'i kaydetmek için belirtilen ayarlarla create_data_source adresini çağırır.
2. MCP sunucusu, veri kaynağını oluşturur ve benzersiz kaynak adını döndürür.
3. Temsilci, ilişkili dosyanın indirilmesini ve işlenmesini tetiklemek için fetch_data_source yöntemini çağırır.
4. Temsilci, yükleme ilerleme durumunu izlemek ve öğelerin başarılı işleme durumunu onaylamak için get_file_upload yöntemini çağırır.

MCP araçları ve açıklamaları

Merchant API MCP Access Service, temsilcinize aşağıdaki araçları sunar: