API Entegrasyonu ve Code Assist Toolkit

Merchant API'ye geçişinizi hızlandırmak ve yapay zeka destekli geliştirme araçlarıyla yeni entegrasyonlar oluşturmak için API Entegrasyonu ve Kod Yardımı Araç Seti'ni kullanın.

Genel Bakış

Content API for Shopping'den Merchant API'ye geçiş yaparken veya yeni bir entegrasyon oluştururken yeni hizmet yapılarını, kaynak adlarını ve yöntemlerini anlamanız gerekir. Yapay zeka destekli geliştirme araçları özellikle aşağıdaki işlemlerde yardımcı olmak için uygundur:

  • Kod çevirisi ve taşıma: Eski Content API for Shopping kodunu anlamanıza ve yeni Merchant API biçimine dönüştürmenize yardımcı olur. Bu işlem, ürün özelliklerinin yeni yapıyla eşlenmesini ve bağımlılık yönetimi dosyalarının güncellenmesini içerir.
  • API dokümanı uzmanlığı: Resmi Google API dokümanlarındaki yetkili bağlama dayalı olarak Merchant API kaynakları, yöntemleri, alanları, kotaları ve en iyi uygulamaları hakkında net açıklamalar sağlar.
  • Kod oluşturma: Python, Java, PHP ve diğer diller de dahil olmak üzere çeşitli dillerde çeşitli Merchant API görevleri için kod snippet'leri oluşturur.
  • Sorun giderme: Yaygın API hatalarının teşhis edilmesine ve düzeltilmesine yardımcı olur.

Geliştirme ortamınıza ve kullanım alanınıza en uygun seçeneği belirleyin. Kurulumu tercih ettiğiniz iş akışına göre uyarlamak için API Entegrasyonu ve Kod Yardımı Araç Seti'ni kullanın:

Aşağıdaki diyagramda, Antigravity, Visual Studio Code, Cursor veya Copilot gibi en yaygın kullanılan Entegre Geliştirme Ortamları (IDE'ler) arasında yapay zeka destekli kod taşıma için kurulum seçenekleri gösterilmektedir. Gemini, Claude, ChatGPT ve Grok gibi kodlama asistanlarını ayarlayabilir, Merchant API Geliştirici Dokümanları MCP sunucusu veya Merchant API Agent Skills ile destekleyerek entegrasyon hızını artırırken daha temelli hale getirebilirsiniz.

(Merchant API) Yapay Zeka Entegrasyonu Kod Asistanı şeması

Merchant API Geliştirici Belgeleri MCP Sunucusu

Tercih ettiğiniz kodlama asistanından Merchant API hakkında bağlamsal bilgiler alın. Artık Model Context Protocol (MCP) hizmetini kullanarak IDE'nizden geliştirici belgelerine erişebilirsiniz. Bu hizmet, kodlama asistanınıza resmi Google API belgelerinden önemli bilgiler sağlar. Protokolün kendisi hakkında daha fazla bilgi için Model Context Protocol standardı konusuna bakın.

İşleyiş şekli

MCP özellikli IDE kodlama asistanınıza Merchant API hakkında bir soru sorduğunuzda hizmet, resmi kaynaklardan en alakalı metin ve kod snippet'lerini alır ve bunları, özel bir Retrieval-Augmented Generation (RAG) arka ucu kullanarak kodlama asistanınıza bağlam olarak döndürür. RAG sistemi, LLM'leri harici ve güncel bilgi kaynaklarına bağlayarak yanıt kalitesini artıran bir sistemdir. Bu sayede, geliştirme ortamınızdan ayrılmanıza gerek kalmadan asistanınız doğru ve güncel yanıtlar verebilir.

Örnek iş akışı:

  1. MCP ile uyumlu kodlama asistanınızda veya aracınızda bir soru sorarsınız (ör. doğal dil sorusu, kod örneği isteği veya kod çevirisi).
  2. Kodlama asistanınız, bağlam için MCP uç noktasına bir istek gönderir.
  3. MCP hizmeti, resmi Merchant API belgeleri, kılavuzları ve kod örneklerinden oluşan dizine eklenmiş koleksiyonunda arama yapar.
  4. Bu hizmet, kodlama asistanınız için bağlam olarak yetkili snippet'ler döndürür.
  5. Kodlama asistanınız, bu bağlamdan yararlanarak temellendirilmiş bir yanıt veya kod çevirisi görevi oluşturur.

Başlarken

MCP'yi entegre etmek ve kullanmak için aşağıdaki adımları uygulayın:

1. Uyumlu bir araç kullanın

Akışa alınabilir HTTP aktarımını destekleyen bir IDE veya kodlama asistanı açın.

2. Uç noktayı yapılandırma

IDE'nizi veya kodlama asistanınızı MCP'ye bağlamak için sağlanan uzak uç nokta ayrıntılarını kullanın. Bu işlem, aracınızın yapılandırmasına bağlı olarak doğrudan hizmet URL'sini veya MCP tanımını girmenizi gerektirebilir:

Yapılandırma kurulumları:

Antigravity

Antigravity belgelerindeki talimatları uygulayın.

"mcpServers": {
  "mapi-devdocs": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-remote",
      "https://merchantapi.googleapis.com/devdocs/mcp"
    ]
  }
}

Visual Studio Code

Visual Studio Code dokümanlarındaki talimatları uygulayın.

"servers": {
"mapi-devdocs": {
  "type": "http",
  "url": "https://merchantapi.googleapis.com/devdocs/mcp/"
  }
}

3. Temsilci talimatları ekleme (isteğe bağlı)

Aracınızın MCP kullanarak kodu doğrudan çevirmesini sağlamak için araca System Instructions: Merchant Integrator Agent Protocol (Sistem Talimatları: Satıcı Entegratörü Aracı Protokolü) talimatını verin. Bu talimatlar, temsilciye kod çevirisi için MCP'yi nasıl doğru şekilde kullanacağı konusunda rehberlik eder. Aracınıza bağlı olarak bu talimatları sistem talimatları yapılandırmasında veya aracı için ek bir bağlam dosyası olarak sağlayabilirsiniz.

Örnek kullanım senaryoları

MCP, aşağıdaki yaygın kullanım alanlarında iş akışınızı hızlandırabilir:

1. senaryo: products.insert kodunu taşıma

Temsilciden, Content API for Shopping products.insert entegrasyon kodunu doğrudan Merchant API'ye taşımasını isteyebilirsiniz.

Kullanıcı istemi:

"products.insert kodunu Merchant API'ye taşıma"

Aracınıza sistem talimatları ve MCP erişimi sağlayarak aracınızın, Shopping için Content API kodunu doğrudan IDE'nizde Merchant API koduna çevirmesini sağlayabilirsiniz. Bu durumda, productInputs.insert eşdeğer çağrı olarak tanımlanır ve eski biçimdeki ürün özellikleri Merchant API'nin gerektirdiği yeni biçimle eşlenir. Ayrıca gerekli içe aktarmaları ve bağımlılık yönetimi dosyasını (ör. requirements.txt, pom.xml veya package.json) da güncelleyebilir. Ajanı, değişiklikleri yerinde yapmaya veya yeni bir klasör oluşturmaya yönlendirebilirsiniz.

2. senaryo: Eşdeğer işlevleri bulma

Content API for Shopping'i kullanan mevcut bir uygulamanız var ve bu uygulamayı güncellemeniz gerekiyor. Yeni uygulama ve ilgili kod örneği hakkında ayrıntılı bilgi edinmek için belirli bir eski yöntemi sorabilirsiniz.

Kullanıcı istemi:

"Content API for Shopping'deki accountstatuses.get yönteminin Merchant API'deki karşılığı nedir?"

MCP hizmeti, resmi taşıma kılavuzlarından ve referans dokümanlarından bağlam bilgisi sağlar. Böylece yardımcınız, yeni API adı da dahil olmak üzere ayrıntılı bir yanıt verebilir accounts.issues.

3. senaryo: Kod örneği bulma

Yeni bir özellik uyguluyorsunuz ve takip etmeniz gereken pratik bir örneğe ihtiyacınız var.

Kullanıcı istemi:

"Show me a Python code sample for adding a new shipping service using Merchant API." (Merchant API'yi kullanarak yeni bir kargo hizmeti eklemeyle ilgili Python kodu örneği göster.)

MCP hizmeti, resmi Google GitHub depolarından ve geliştirici kılavuzlarından ilgili kod örneklerini alır. Bu şekilde asistanınız, eksiksiz ve uyarlanmaya hazır bir kod bloğu sunabilir.

4. senaryo: API kavramlarını anlama

Yeni bir kavramla karşılaşırsanız veya bir kaynağın yapısını ya da genel Merchant API kalıbını anlamak isterseniz.

Kullanıcı istemi:

"Merchant API'yi kullanarak bir ürünün envanterini nasıl güncellerim?"

MCP hizmeti, ürün kaynağı dokümanlarından ve ilgili kılavuzlardan bağlam döndürür. Ardından asistanınız, accounts.productInputs.insert yönteminin nasıl kullanılacağını açıklayabilir ve yalnızca accounts.productInputs.insert ile güncellemeniz gereken envanterle ilgili alanları içeren kısmi ürün kaynağını sağlayabilir.productId

"Uygulama çağrılarımı Merchant API ile nasıl yetkilendiririm?"

MCP hizmeti, farklı yetkilendirme yöntemlerini kapsayan resmi kimlik doğrulama kılavuzlarından bağlam alır. Ardından asistanınız, sunucudan sunucuya etkileşimler için hizmet hesabı kullanma veya kullanıcı adına işlem yaparken OAuth 2.0 istemci kimliği kullanma gibi mevcut temel seçenekleri açıklayabilir.

5. senaryo: API değişikliklerine uyum sağlama

Merchant API, Content API for Shopping'den farklı olan yeni kalıplar (ör. istekleri gruplandırma) sunar. Content API for Shopping belirli custombatch yöntemleri kullanırken Merchant API, yerleşik ve genel bir HTTP toplu işleme özelliği kullanır.

Kullanıcı istemi:

"Merchant API'de products.custombatch işlemini yapmanın yeni yolu nedir?"

MCP hizmeti, Eşzamanlı istekler için kodu yeniden düzenleme başlıklı makaleden bağlam bilgisi alır. Bu makalede, Merchant API'de özel custombatch yöntemlerinin olmadığı açıklanır. Bunun yerine, Content-Type ile HTTP toplu işleme özelliğini kullanma hakkında dokümanlar sunar.multipart Ardından asistanınız, https://merchantapi.googleapis.com/batch/{sub-api}/v1 uç noktasına gönderilen ve birden fazla API çağrısı içeren tek bir HTTP isteğinin nasıl oluşturulacağını açıklayabilir ve çok bölümlü isteğin nasıl yapılandırılacağına dair bir örnek verebilir. Bu sayede, kafa karıştırıcı olabilecek bir taşıma görevi, rehberli bir sürece dönüştürülür.

6. senaryo: Raporlama sorgusunu çevirme

Aracıdan, Content API for Shopping'deki bir raporlama sorgusunu Merchant API'ye çevirmesini isteyebilirsiniz.

Kullanıcı istemi:

"Bu raporlama sorgusunu Content API'den Merchant API'ye taşıyın: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

MCP hizmeti, en son raporlama referans belgelerini, geliştirici kılavuzlarını ve taşıma kılavuzlarını alır. Bu bilgilere göre sorguyu yeni yapıya dönüştürür ve alanları yeni adları ve değerleriyle günceller.

Merchant API Agent Skills

Aracı Becerileri spesifikasyonu, yapay zeka geliştirme araçlarında kullanılan açık bir standarttır. Geliştirici deneyiminizi iyileştirmek ve hem Content API for Shopping'den geçiş yaparken hem de yeni entegrasyonlar oluştururken deneyiminizi optimize etmek için Agent Skills'i kullanın. Merchant API Agent Skills paketleri, yapay zeka temsilcilerinin özelliklerini geliştirmek için alana özgü bilgiler ve araçlar içerir. Ayrıca, doküman sorguları, kod oluşturma ve sorun giderme konusunda isteğe bağlı uzman yardımı sağlar.

Merchant API Agent Skills, Gemini ve Claude Code gibi çeşitli yapay zeka destekli komut satırı araçları ve IDE'lerle uyumludur.

İşleyiş şekli

Merchant API Agent Skills, açık Agent Skills standardı üzerine kurulmuş özel bir uzmanlık paketi sunar. Temsilci becerimiz mapi-developer-assistant, yapay zeka geliştirme araçlarınız ile temel Merchant API Dev Doc MCP Sunucusu arasında akıllı bir katman görevi görür. Aşağıdaki özelliklere sahip olan bu model, alan uzmanlığı ve prosedürlerle ilgili rehberlik sunar:

  • Sıfır Yapılandırma: MCP sunucu bağlantılarını otomatik olarak yönetir ve manuel uç nokta kurulumu ihtiyacını ortadan kaldırır.
  • Uzman İş Akışları: En alakalı bilgileri etkili bir şekilde getirmek için kullanıcı istemlerini optimize edilmiş sorgulara dönüştürür.
  • Bağlam Yönetimi ve Jeton Verimliliği: Bilgileri isteğe bağlı olarak yüklemek ve yapay zekanın bağlam penceresini korumak için "Aşamalı Açıklama"yı kullanır.
  • Gelişmiş Çıkış Biçimlendirme: İşleme alınabilir, okunabilir ve tutarlı yanıtlar için çıkışı biçimlendirme ve yapılandırma talimatları sağlar.

Örnek iş akışı:

  1. Bir yapay zeka geliştirme aracında Merchant API ile ilgili soru soruyorsanız.
  2. Merchant API Agent Skill, amacınızı analiz eder, kesin bir sorgu oluşturur ve prosedür bilgisini isteğe uygular.
  3. Agent Skill, bağlam için merchantapi.googleapis.com/devdocs/mcp/ adresinde bulunan Merchant API Dev Doc MCP sunucusuna istek gönderir.
  4. MCP hizmeti, resmi Merchant API belgeleri, kılavuzları ve kod örneklerinden oluşan dizine eklenmiş koleksiyonunda arama yapar.
  5. Yapay zeka aracınız, sentezlenmiş ve uygulanabilir bir yanıt sağlamak için bu bilgilerden yararlanır.

Başlarken

Merchant API Agent Skills README, aşağıdaki konularda adım adım rehberlik sağlar:

  • Gemini komut satırı aracı gibi araçlar için ön koşullar.
  • Seçtiğiniz araçta Agent Skills desteğini etkinleştirme
  • README dosyasında belirtildiği şekilde GitHub deposundan mapi-developer-assistant becerisini yükleyin.
  • Yükleme doğrulanıyor.
  • Temel beceri yönetimi komutları.

Gemini komut satırı aracı, Claude Code ve diğerleri dahil olmak üzere çeşitli yapay zeka araçlarının ayrıntılı yükleme ve kurulum talimatları için README dosyasındaki yönergeleri uygulayın.

Örnek istemler

Yapay zeka geliştirme araçlarınıza yüklenip etkinleştirildikten sonra mapi-developer-assistant becerisi, Merchant API ile ilgili sorular sorduğunuzda genellikle otomatik olarak etkinleştirilir.

"Python'da Merchant API kullanarak nasıl ürün ekleyebilirim?"

"Content API accountstatuses.get yönteminin Merchant API'deki karşılığı nedir?"

"Merchant API ile kimlik doğrulama işlemenin Java örneğini göster."

"productInputs.insert numarası arandığında doğrulama hatasıyla birlikte "400 Bad Request" hatası alıyorum. Bu sorunu nasıl düzeltebilirim?"

"Merchant API'de ProductInput ile Product arasındaki fark nedir?"

Bilgi bankası kaynakları

MCP hizmeti, sağladığı bağlamın doğru ve güvenilir olmasını sağlamak için bilgi tabanını yalnızca herkese açık ve resmi kaynaklardan oluşturur. Hizmet, resmi geliştirici sitesinin ve kod örneği deposunun tüm içeriğini (ör. aşağıdakiler) indeksler: