Manufacturer Center (MfC) API, uygulamaların doğrudan Manufacturer Center platformuyla etkileşim kurmasına olanak tanır. Başlamanıza yardımcı olmak için Java ve .NET'te kod örnekleri sunuyoruz.
Bu kılavuz, Manufacturer Center API'yi kullanarak ilk uygulamanızı oluşturmanıza yardımcı olacaktır. Kodlamaya başlamadan önce yapmanız gereken birkaç şey var.
REST Desteği
REST API'miz, 2 farklı kaynak türü için temel CRUD işlemlerini destekler:
- Marka Sahipleri ve Veri İş Ortakları için Ürün.
- Ve Sertifika Kurumları için ProductCertification.
Bu belgenin geri kalanı ağırlıklı olarak Product için yazılır ancak ProductCertification için benzer bir süreç izlenir.
Manufacturer Center hesabınızı oluşturun
Manufacturer Center Hesabı oluşturun.
Bu Manufacturer Center hesabını oluştururken hangi e-posta adresini kullandığınızı unutmayın. Daha sonra buna ihtiyacınız olacak. Ekran görüntülerinde manufacturer_user@example.com olarak temsil edildiğini görürsünüz.
İlk API isteğinizi yapın (kod satırı olmadan!)
Accounts.Products.list
için geliştirici dokümanlarımızdaki APIs Gezgin'e gidin.Giriş yapmış olduğunuz Google hesabının, Ayarlar sekmesindeki "Kullanıcılar" ayarında listelendiğinden emin olun.
API Gezgini'ndeki Kimlik Doğrulama açılır menüsünde Google OAuth 2.0'ın seçili olduğundan emin olun:
Formun "üst" alanına
accounts/{account_id}
değerini girip{account_id}
yerine Manufacturer Center hesabınızdaki Üretici Kimliği'ni girin. Ardından Yürüt'ü tıklayın.Başarılı bir yanıt görmeniz gerekir. Tebrikler! İlk Manufacturer Center API isteğinizi gönderdiniz.
Manufacturer Center hesabınızda henüz ürün yoksa listede de ürün bulunmaz. Bu noktada diğer isteklere atlayabilir ve neler yaptıklarına göz atabilirsiniz. Bu bir RESTful API olduğundan tüm istekler benzer şekilde çalışır. Ürünleriniz hazır olduğunda bir sonraki adım
Accounts.Products.get
'ı denemektir.
Google API Konsol Projesi oluşturma
Manufacturer Center API'ye yapılan istekler API Konsolu projeniz üzerinden yapılır. Burada kendi Manufacturer Center hesabınıza erişeceğinizi varsayıyoruz. Bu nedenle, kimlik doğrulama akışını basitleştirmek için hizmet hesaplarını kullanmanızı öneririz. Manufacturer Center hesabınızla kullanılacak yeni bir hizmet hesabı oluşturmayla ilgili ayrıntılar için Hizmet Hesapları Kılavuzu'na bakın.
Java kullanan ilk yetkilendirilmiş API isteğiniz
Hizmet hesabı oluşturduğunuza ve hizmet hesabı kimliğini Manufacturer Center hesabınıza eklediğinize göre artık mevcut Samples kodunu kullanarak hesabınıza erişebilirsiniz. Bu kılavuzda, API'nin nasıl kullanıldığını göstermek için Java örnekleri kullanılmaktadır.
Henüz yapmadıysanız Apache Maven'i yükleyin.
Alışveriş örneklerimizi GitHub sayfamızdan indirin.
java
alt dizininden Java örneklerini oluşturun:$ mvn compile
Şimdi
ProductsListSample
kodunu çalıştırın (ProductCertification için örnekListProductCertificationsSample
olmalıdır):$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
Kaynak dosyalara eşlik eden BENİOKUOKU bölümündeki yapılandırma talimatlarını uygulamadıysanız örnek yapılandırma bulunamadığını belirten bir hata alırsınız. Yapılandırma dizinini oluşturmak ve bu dizini uygun bilgilerle doldurmak için BENİOKU'daki talimatları uygulayın. Hizmet hesabınızı oluştururken indirdiğiniz JSON dosyası,
service-account.json
dosya adıyla o dizine yerleştirilmelidir. Aşağıdaki ortam değişkenini ayarlayarak koda dosyanızın yerini belirtmeyi unutmayın.export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
Artık örnek yapılandırmasını ayarladığınıza göre
ProductsListSample
kodunu tekrar çalıştırın.$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
Bu noktada, Java programı yürütme işlemini tamamlamalı ve bulduğu ürünlerin listesini veya hesabınızda ürün olmadığını belirten bir mesajı yazdırmalıdır. "Kullanıcı 1234567890 numaralı hesaba erişemiyor" gibi bir hata mesajı alırsanız büyük olasılıkla hizmet hesabı kullanıcısını Manufacturer Center'da yetkili kullanıcı olarak ayarlamamışsınızdır. API açısından bakıldığında API Konsolu projesi, yetkili Manufacturer Center yöneticileri listesinde olmayan bir kullanıcı adına bir istek gönderdiğinden bu istek elbette reddedilecektir.
Bu salt okunur bir istek olduğundan
ProductsListSample
öğesini çalıştırmayı istediğiniz kadar deneyebilirsiniz. Hem Java hem de .NET için oluşturduğumuz diğer örnekleri de inceleyebilirsiniz.