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 işlemde 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. Kimlik doğrulama için API anahtarlarının kullanılması desteklenmez ve kimlik doğrulama hatalarına neden olur. 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 bir Merchant Center hesabı kullanarak hangi işlemleri yapmasına izin verildiğini belirler. Merchant Center hesabında kimliği doğrulanmış kullanıcıya verilen roller ve izinlere göre "Ne yapabilirsiniz?" sorusunu yanıtlar. Örneğin, bir kullanıcı ürün verilerini okuma yetkisine sahip olabilir ancak hesap ayarlarını değiştiremez.
- Kayıt: Merchant API ile ilgili olarak bu, Google'ın yönettiğiniz satıcı hesapları için önemli hizmet duyuruları göndermesine olanak tanıyan tek seferlik bir kurulum işlemidir. Kayıt işlemi, geliştirici e-posta adreslerinizi ana Merchant Center hesabınıza ekler ve kimlik doğrulama için kullandığınız Google Cloud proje kimliklerine bağlar. Bu bağlantı, uygulamanızın yönettiğiniz tüm satıcı hesapları için hizmet duyuruları almasını sağlar. Daha fazla bilgi için Google Cloud projesi oluşturma başlıklı makaleyi inceleyin.
Kayıt
Kayıt süreci, 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ın olması gerekir.
- Yönetici erişimi: Kayıt çağrısını başlatmak için kullandığınız Google kullanıcı hesabının, kaydettiğiniz Merchant Center hesabında yönetici ayrıcalıklarına sahip olması gerekir.
- Google Cloud projesi: Uygulamanız bir Google Cloud projesiyle ilişkilendirilmelidir. Bu proje, uygulamanızın kimlik doğrulaması yapması 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. Paylaşılan projelerle kaydolamazsınız. Bunun nedeni:
- Bu kimlikler, üretim uygulaması kimliği için değil, test ve keşif için tasarlanmıştır.
- Bu adresleri kaydetmeniz, paylaşılan araç ile Merchant Center verileriniz arasında bir bağlantı olduğu anlamına gelir ve istenmeyen iletişimlere neden olabilir.
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 projesine ihtiyacı vardır.
Bununla birlikte, Merchant API'yi deneme ve üretim dışı kullanım alanları için kullanmak üzere 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 aramasını yapma
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, Merchant API ile ilgili önemli güncellemeler, zorunlu hizmet duyuruları, geliştirici anketleri ve diğer fırsatları gönderir. Doğru kişi yönetimi, bu bilgilerin doğru kişilere ulaşmasını sağlar.
- Amaç: Google, API ile ilgili iletişimler için öncelikli kişi olarak bu e-posta adresini kullanır.
- Kimin e-posta adresi: Bu, bireysel bir geliştiricinin veya API entegrasyonundan sorumlu önemli bir teknik iletişim kişisinin e-posta adresi olmalıdır.
- En iyi uygulamalar:
- DO: Kişinin kurumsal e-posta adresini kullanın.
- YAPMAYIN: Genel grup takma adları veya hizmet hesabı e-postaları kullanmayın. İletişimlerimizin insan alıcılara yönelik olmasını amaçlıyoruz.
Kişi yönetimi için users kaynağı
Kayıt çağrısındaki e-posta adresi ilk iletişim kişisini belirler ancak iletişim kişilerini 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 kişileri 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 bildirimleri alması gereken kullanıcılara bu rolü atayın. Bu rolü diğer rollerle birleştirebilirsiniz.- Avantajlar:
- Net ayrım: API iletişim 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 özel haberlerin ilgili kişilere ulaşmasını sağlar.
Kayıt sırasında bir e-posta adresi vermiş olsanız bile API ile ilgili kişileri API_DEVELOPER rolüne sahip kullanıcılar ekleyerek yönetmenizi önemle tavsiye ederiz.
Referanslar
Daha fazla bilgi için aşağıdaki makaleleri inceleyin: