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 Integration and Code Assist Toolkit'i 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öntemleri 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, ürün özelliklerini yeni yapıya eşlemeyi ve bağımlılık yönetimi dosyalarını güncellemeyi içerir.
  • API belgeleri uzmanlığı: Resmi Google API belgelerindeki 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 dillerde çeşitli Merchant API görevleri için kod snippet'leri oluşturur.
  • Sorun giderme: Sık karşılaşılan API hatalarını teşhis etmeye ve düzeltmeye yardımcı olur.

Geliştirme ortamınıza ve özel 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 Code Assist Araç Seti'ni kullanın:

Aşağıdaki diyagramda, Antigravity, Visual Studio Code, Cursor veya Copilot gibi en çok tercih edilen entegre geliştirme ortamlarında (IDE) yapay zeka destekli kod taşıma işlemi için kurulum seçenekleri gösterilmektedir. Gemini, Claude, ChatGPT ve Grok gibi kod yazma desteği asistanlarını ayarlayabilir ve entegrasyon hızını artırırken daha kaynağa dayalı olmaları için Merchant API Geliştirici Belgeleri MCP sunucusu veya Merchant API Temsilci Becerileri ile güçlendirebilirsiniz.

(Merchant API) Yapay Zeka Entegrasyonu Kod Yazma Desteği diyagramı

Merchant API Geliştirici Belgeleri MCP Sunucusu

Tercih ettiğiniz kod yazma desteğinden Merchant API hakkında bağlamsal bilgi alın. IDE'nizde artık Model Context Protocol (MCP) hizmetini kullanarak geliştirici belgelerine erişebilirsiniz. Bu hizmet, kodlama asistanınıza Google API'nin resmi belgelerinden önemli bilgiler sağlar. Protokol hakkında daha fazla bilgi için Model Context Protocol standardı sayfasını inceleyin.

İşleyiş şekli

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

Örnek iş akışı:

  1. MCP uyumlu kod yazma desteği asistanınızda veya ajanınızda bir soru sorarsınız (ör. doğal dilde soru, kod örneği isteği veya kod çevirisi).
  2. Kod yazma desteğiniz, MCP uç noktasına bağlam isteği gönderir.
  3. MCP hizmeti, dizine eklenmiş resmi Merchant API belgeleri, kılavuzları ve kod örnekleri koleksiyonunda arama yapar.
  4. Hizmet, kodlama asistanınıza bağlam olarak yetkili snippet'ler döndürür.
  5. Kod yazma desteğiniz, bu bağlamdan yararlanarak kaynağa dayalı 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ç kullanma

Akışlı HTTP aktarımı ile Model Bağlam Protokolü'nü destekleyen bir entegre geliştirme ortamı veya kod yazma desteği açın.

2. Uç noktayı yapılandırma

IDE'nizi veya kod yazma desteğinizi MCP'ye bağlamak için sağlanan uzak uç nokta ayrıntılarını kullanın. Aracınızın yapılandırmasına bağlı olarak doğrudan hizmet URL'sini veya MCP tanımını girmeniz gerekebilir:

Yapılandırma ayarları:

Antigravity

Antigravity dokümanlarındaki talimatları uygulayın.

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

Visual Studio Code

Visual Studio Code belgelerindeki talimatları uygulayın.

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

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

Temsilcinizin MCP'yi kullanarak kodu doğrudan çevirmesini sağlamak için temsilciye Sistem Talimatları: Merchant Integrator Agent Protocol'ü sağlayın. Bu talimatlar, temsilciye kod çevirisi için MCP'yi doğru şekilde nasıl kullanacağı konusunda yol gösterir. Kullandığınız araca bağlı olarak bu talimatları sistem talimatları yapılandırmasında veya temsilci 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şı"

Temsilcinize sistem talimatları ve MCP'ye erişim izni vererek temsilcinizin Content API for Shopping kodunu doğrudan IDE'nizde Merchant API koduna çevirmesini sağlayabilirsiniz. Bu durumda, productInputs.insert yöntemini eşdeğer çağrı olarak tanımlar ve ürün özelliklerini eski biçimden Merchant API'nin gerektirdiği yeni biçime eşler. Ayrıca gerekli içe aktarma işlemlerini ve bağımlılık yönetimi dosyasını (ör. requirements.txt, pom.xml veya package.json) güncelleyebilir. Temsilciye değişiklikleri yerinde yapmasını veya yeni bir klasör oluşturmasını söyleyebilirsiniz.

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öntem hakkında soru sorabilirsiniz.

Kullanıcı istemi:

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

MCP hizmeti, resmi geçiş rehberlerinden ve referans belgelerinden bağlam bilgisi sağlar. Böylece asistanınız, yeni API adı (accounts.issues) dahil olmak üzere ayrıntılı bir yanıt verebilir.

3. senaryo: Kod örneği bulma

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

Kullanıcı istemi:

"Merchant API'yi kullanarak yeni bir kargo hizmeti eklemeyle ilgili Python kod örneği göster."

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

4. senaryo: API kavramlarını anlama

Yeni bir kavramla karşılaştığınızda veya bir kaynağın yapısını ya da genel Merchant API modelini anlamak istediğinizde.

Kullanıcı istemi:

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

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

"Merchant API ile uygulama çağrılarımı nasıl yetkilendirebilirim?"

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

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

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

Kullanıcı istemi:

"Merchant API'de products.custombatch işlemini gerçekleştirmenin yeni yolu nedir?"

MCP hizmeti, Eşzamanlı istekler için kodu yeniden düzenleme bölümünden bağlamı alır ve Merchant API'de özel custombatch yöntemlerinin bulunmadığını açıklar. Bunun yerine, multipart Content-Type ile HTTP toplu işleminin kullanımına ilişkin belgeler sağlar. Asistanınız daha sonra, birden fazla API çağrısı içeren tek bir HTTP isteğinin nasıl oluşturulacağını ve https://merchantapi.googleapis.com/batch/{sub-api}/v1 uç noktasına nasıl gönderileceğini açıklayabilir ve çok parçalı isteğin nasıl yapılandırılacağına dair bir örnek verebilir. Bu sayede, kafa karıştırıcı olabilecek taşıma görevi rehberli bir sürece dönüşür.

6. senaryo: Raporlama sorgusunu çevirme

Temsilciden, 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 geçiş rehberlerini alır. Bu bilgilere dayanarak sorguyu yeni yapıya dönüştürür ve alanları yeni adları ve değerleriyle günceller.

Merchant API Temsilci Becerileri

Agent Skills spesifikasyonu, yapay zeka geliştirme araçlarında benimsenen açık bir standarttır. Geliştirici deneyiminizi iyileştirmek ve hem Content API for Shopping'den geçiş yapma hem de yeni entegrasyonlar oluşturma süreçlerini optimize etmek için temsilci becerilerini kullanın. Merchant API Agent Skills, yapay zeka ajanlarının yeteneklerini geliştirmek için alana özgü bilgi ve araçları paketler ve doküman sorguları, kod oluşturma ve sorun giderme konularında seç-izle uzman yardımı sağlar.

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

İşleyiş şekli

Merchant API Temsilci Becerileri, açık Temsilci Becerileri standardına dayalı özel bir uzmanlık paketi sunar. Temsilci becerimiz mapi-developer-assistant, yapay zeka geliştirme araçlarınız ile temel Merchant API Geliştirici Belgesi MCP Sunucusu arasında akıllı bir katman görevi görür. Alan uzmanlığı ve prosedür rehberliği sunan bu model, aşağıdaki özelliklere sahiptir:

  • Sıfır yapılandırma: MCP sunucusu bağlantılarını otomatik olarak yöneterek 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 seç-izle olarak yüklemek ve yapay zekanın bağlam penceresini korumak için "Kademeli Açıklama"yı kullanır.
  • Gelişmiş Çıkış Biçimlendirme: Uygulanabilir, okunabilir ve tutarlı yanıtlar için çıkışı biçimlendirme ve yapılandırma talimatları sağlar.

Örnek iş akışı:

  1. Yapay zeka geliştirme aracında Merchant API ile ilgili bir soru soruyorsunuz.
  2. Merchant API Agent Skill, niyetinizi analiz eder, kesin bir sorgu oluşturur ve prosedür bilgisini isteğe uygular.
  3. Temsilci becerisi, merchantapi.googleapis.com/devdocs/mcp/ adresinde bulunan Merchant API Geliştirici Belgesi MCP sunucusuna bağlam isteği gönderir.
  4. MCP hizmeti, dizine eklenmiş resmi Merchant API belgeleri, kılavuzları ve kod örnekleri koleksiyonunda arama yapar.
  5. Yapay zeka temsilciniz, bu bilgileri kullanarak sentezlenmiş ve uygulanabilir bir yanıt verir.

Başlarken

Merchant API Agent Skills README dosyasında aşağıdaki konularla ilgili adım adım açıklamalar yer alır:

  • Antigravity komut satırı aracı gibi araçlar için ön koşullar.
  • Seçtiğiniz araçta Temsilci Becerileri desteğini etkinleştirme
  • README dosyasındaki talimatları uygulayarak GitHub deposundan mapi-developer-assistant becerisini yükleme
  • Yükleme doğrulanıyor.
  • Temel beceri yönetimi komutları.

Antigravity komut satırı aracı ve Claude Code gibi ç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'deki accountstatuses.get yönteminin Merchant API'deki karşılığı nedir?"

"Merchant API ile kimlik doğrulama işlemini gerçekleştirmek için Java örneği göster."

"productInputs.insert yöntemini çağırırken doğrulama hatasıyla birlikte '400 Hatalı İstek' hatası alıyorum. Bu sorunu nasıl giderebilirim?"

"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 dizine ekler. Buna şunlar dahildir: