Merchant API'yi etkili bir şekilde kullanmak için kayıt, kimlik doğrulama ve yetkilendirme kavramlarını anlamak önemlidir. Merchant Center verilerine güvenli ve doğru erişim sağlamak için farklı amaçlara hizmet ederler.
Terminoloji
Kayıt, kimlik doğrulama ve yetkilendirme birbiriyle ilişkili olsa da her birinin farklı bir anlamı ve amacı vardır.
- Kimlik doğrulama: Bu süreçte hizmet, API isteğinde bulunan kullanıcının veya uygulamanın kimliğini doğrular. Merchant API, OAuth 2.0 gibi standart Google mekanizmalarını kullanır. Daha fazla bilgi için İsteklerin kimliğini doğrulama ve Kendi hesabınız olarak kimlik doğrulama başlıklı makaleleri inceleyin.
- Yetkilendirme: Bu işlem, kimliği doğrulanmış kullanıcının veya uygulamanın Merchant Center hesabı kullanarak hangi işlemleri yapmasına izin verildiğini belirler. Kimliği doğrulanmış kullanıcıya Merchant Center hesabında verilen roller ve izinlere göre "Ne yapabilirsiniz?" sorusunun yanıtını verir. Örneğin, bir kullanıcı ürün verilerini okumaya yetkili olabilir ancak hesap ayarlarını değiştirmeye yetkili olmayabilir.
- Kayıt: Merchant API ile ilgili olarak bu, Google'ın yönettiğiniz satıcı hesapları için size önemli hizmet duyuruları göndermesine olanak tanıyan tek seferlik bir kurulum sürecidir. Kaydolduğunuzda geliştirici e-posta adresleriniz ana Merchant Center hesabınıza eklenir ve bu hesap, kimlik doğrulama için kullandığınız Google Cloud projesi kimliklerine bağlanır. Bu bağlantı, uygulamanızın yönettiğiniz tüm satıcı hesapları için hizmet duyuruları almasına olanak tanır. Daha fazla bilgi için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.
Kayıt
Kayıt işlemi, uygulamanızın Merchant API'yi kullanabilmesi için çok önemlidir. Şunları bilmeniz gerekir:
Ön koşullar
Merchant API'yi kullanmak için kaydolmak üzere aşağıdakiler gerekir:
- Merchant Center hesabı: Mevcut bir Merchant Center hesabınız olmalıdır.
- Yönetici erişimi: Kayıt görüşmesini başlatmak için kullandığınız Google kullanıcı hesabının, kayıt yaptırdığınız Merchant Center hesabında yönetici ayrıcalıkları olmalıdır.
- Google Cloud projesi: Uygulamanız bir Google Cloud projesiyle ilişkilendirilmelidir. Bu proje, uygulamanızın kimliğini doğrulaması için gerekli kimlik bilgilerini (ör. OAuth 2.0 istemci kimlikleri) sağlar.
Paylaşılan bir Google Cloud projesini neden kaydedemezsiniz?
Google OAuth Playground ve API Gezgini gibi araçlar, Google'a ait paylaşılan Google Cloud projelerini kullanır. Aşağıdaki nedenlerden dolayı paylaşılan projelerle kaydolamazsınız:
- Bunlar üretim uygulaması kimliği için değil, test ve keşif için tasarlanmıştır.
- Bu araçların kaydedilmesi, paylaşılan araç ile belirli Merchant Center verileriniz arasında bağlantı olduğu anlamına gelir ve istenmeyen iletişimlere yol açabilir.
Google'ın size gönderdiği Merchant API iletişimlerinin gerçek kullanımınızla alakalı kalması için uygulamanızın kendi özel Google Cloud projesi olması gerekir.
Bununla birlikte, deneme ve üretim dışı kullanım alanlarında Merchant API'yi kullanmak için OAuth Playground ve API Gezgini web uygulamalarını kullanabilirsiniz.
Google Cloud proje kimliğinizi bulma
Proje kimliğinizi ve proje numaranızı Google Cloud Console'da bulabilirsiniz. Ayrıntılar için Proje adını, numarasını ve kimliğini bulma başlıklı makaleyi inceleyin.
Kayıt görüşmesini yapın
Accounts alt API'sindeki
registerGcp
yöntemini kullanarak kaydolun. Bu çağrı, Google Cloud proje numaranızı Merchant Center hesabıyla ilişkilendirir.
İşlem sırasında, API'yi çağırmak için kullandığınız bireysel bir kullanıcıyla ilişkili bir e-posta adresi sağlamanız gerekir. Bu e-posta adresi, Merchant Center hesabına yönetici erişimi olan bir kullanıcıya ait olmalıdır.
E-posta alanı hakkında
Etkili iletişim çok önemlidir. Google, önemli güncellemeler, zorunlu hizmet duyuruları (MSA'lar), geliştirici anketleri ve Merchant API ile ilgili diğer fırsatları gönderir. Doğru kişi yönetimi, bu iletilerin doğru kişilere ulaşmasını sağlar.
- Amaç: Google, bu e-posta adresini API ile ilgili iletişimler için birincil iletişim adresi olarak kullanır.
- Kimin e-posta adresi: Bu, API entegrasyonundan sorumlu olan bağımsız bir geliştiricinin veya önemli bir teknik yetkilinin e-posta adresi olmalıdır.
- En İyi Uygulamalar:
- YAPILMASI GEREKENLER: Bireylerin kurumsal e-posta adresini kullanın.
- YAPMAYIN: Genel grup takma adları veya hizmet hesabı e-postaları kullanmayın. İletişimlerimizi gerçek alıcılar için tasarlarız.
Kişi yönetimi için users kaynağı
Kayıt çağrısındaki e-posta adresi ilk kişiyi belirlese de kişileri ve izinleri yönetmenin daha sağlam yolu Merchant API
accounts.users
kaynağını veya Merchant Center kullanıcı arayüzündeki kullanıcı yönetimi ayarlarını kullanmaktır. Merchant Center'ı kullanma hakkında daha fazla bilgi için Hesabınızdaki kullanıcıları yönetme başlıklı makaleyi inceleyin.
Bu özelliklerden aşağıdaki şekilde yararlanabilirsiniz:
- Tüm geliştiricileri ekleyin: API entegrasyonu üzerinde çalışan geliştiricileri Merchant Center hesabının kullanıcıları olarak ekleyin.
API_DEVELOPERrolünü atama: Standart rollerin (Yönetici, Standart) yanı sıra kullanıcılaraAPI_DEVELOPERrolünü de atayabilirsiniz. Özellikle, API ile ilgili iletişimleri alması gereken kullanıcılara bu rolü atayın. Diğer rollerle birleştirebilirsiniz.- Avantajlar:
- Net ayrım: API kişi yönetimini tek seferlik kayıttan ayırır.
- Esneklik: Ekip üyeleri değiştikçe kişileri güncelleyin.
- Hedefli iletişim: API'ye özgü haberlerin ilgili kişilere gönderilmesini sağlar.
Kayıt sırasında bir e-posta adresi sağlamış olsanız bile, API_DEVELOPER rolüne sahip kullanıcılar ekleyerek API ilgililerini yönetmenizi önemle tavsiye ederiz.
Referanslar
Daha fazla bilgi için aşağıdaki kaynaklara bakın: