Merchant API için kimlik doğrulama ayarlama

Veri güvenliğini sağlamak, erişim denetimini uygulamak ve sistem bütünlüğünü korumak için tüm Merchant API isteklerinin kimliğini doğrulamanız gerekir. API, arayanın hangi işlemleri gerçekleştirme izni olduğunu belirlemek için kimliği doğrulanmış kimliği kullanır. Örneğin, bazı arayanlar ürün verilerine salt okuma erişimine sahipken diğerleri Merchant Center'da hesap ayarlarını değiştirebilir.

Bu doküman, Merchant API'yi kullanmaya başlama ile ilgili çok bölümlü bir serinin parçasıdır. Merchant API ile kimlik doğrulama ayarlarını yaptıysanız sonraki bölüme geçebilirsiniz: Geliştirici olarak kaydolma

Merchant API isteklerini yetkilendirme

Merchant API'ye gönderilen her istek, uygulamanızı Google'a tanıtmak için bir yetkilendirme jetonu içermelidir. Kimlik doğrulama ve yetkilendirmeyi ayarlamak için Merchant API ile çalışmayı planladığınız yöntemi en iyi açıklayan kullanım alanına karar verin:

Diğer işletmelerin kullanacağı bir uygulama mı geliştiriyorsunuz?

Cevabınız evet ise OAuth 2.0 yetkilendirmesini kullanırsınız. Aşağıdaki durumlarda OAuth 2.0 yetkilendirmesini seçin:

• Üçüncü taraf sağlayıcı veya ajanssanız: Diğer işletmelerin kendi Merchant Center verilerini yönetmek için kullanacağı bir uygulama (ör. SaaS platformu) geliştiriyorsunuzdur.
• Çok sayıda harici hesabı yönetmeniz gerekiyorsa: Farklı müşterilere ait birden fazla bağımsız Merchant Center hesabında tek bir uygulamanın çalışmasını istiyorsanız. Müşterileriniz kendi Google Hesaplarında oturum açıp kullanıcı rızası ekranında "İzin ver"i tıklayarak izin verir.

Kendi işletmeniz için bir uygulama mı geliştiriyorsunuz?

Evet ise Merchant API erişimi elde etmek için hizmet hesabı yetkilendirmesi kullanırsınız. Aşağıdaki durumlarda hizmet hesabı yetkilendirmesini seçin:

• Kendi şirket içi uygulamanızı oluşturuyorsanız: Kendi Merchant Center verilerinizi yönetmek için özellikle kendi işletmenize yönelik bir araç geliştiriyorsanız veya kimlik bilgilerinin belirli bir kullanıcıya değil, uygulamanın kendisine ait olmasını istiyorsanız.
• Kullanıcı girişi olmadan otomasyona ihtiyacınız varsa: Uygulamanız, otomatik envanter güncellemeleri veya "cron" işleri gibi arka plan görevleri çalıştırıyorsa.

OAuth 2.0 yetkilendirmesi

Birden fazla müşteri hesabını yöneten bir üçüncü taraf sağlayıcı veya ajanssanız uygulamanızın istekleri yetkilendirmek için OAuth 2.0 kullanması gerekir. Merchant API için OAuth 2.0'ı ayarlamak üzere aşağıdaki adımları uygulayın:

1. Google Cloud Console'unuzdaki API'ler ve Hizmetler bölümünde OAuth 2.0 kimlik bilgileri oluşturun.
2. OAuth2 istemci kimlik bilgilerini aşağıdaki gibi bir dosyaya indirin: client-secrets.json
3. E-posta hesabını Merchant Center'a kullanıcı olarak ekleyin: İstekleri yetkilendirmek için kullandığınız Google Hesabı'nın Merchant Center'da kullanıcı olarak mevcut olduğundan emin olun. Daha fazla bilgi için Merchant Center'a kullanıcı ekleme veya kaldırma başlıklı makaleyi inceleyin.
4. Kayıt işlemini gerçekleştirmek için Admin rolünü atayın. Roller hakkında daha fazla bilgi için Merchant Center'da kişiler ve erişim düzeylerini yönetme başlıklı makaleyi inceleyin.
5. Kod örnekleriyle kimlik doğrulamayı ayarlama: Resmi kod örnekleri Kimlik Doğrulamayı Ayarlama ve Örnek Yapılandırma dokümanları bölümündeki talimatları uygulayın.

OAuth 2.0 yetkilendirmesi hakkında daha fazla bilgi için Üçüncü taraf uygulamalarının Merchant Center hesabına erişimini yetkilendirme ve Google API'lerine erişmek için OAuth 2.0'ı kullanma başlıklı makaleleri inceleyin.

Hizmet hesabı yetkilendirmesi

Kendi Merchant Center hesabınıza Merchant API erişimini yetkilendirmek için hizmet hesabı kullanırsınız. Merchant API için hizmet hesabı yetkilendirmesini ayarlamak üzere aşağıdaki adımları uygulayın:

1. Google Cloud Console'unuzdaki API'ler ve Hizmetler bölümünde hizmet hesabı kimlik bilgileri oluşturun.
2. Özel anahtarı indirin: Hizmet hesabı için JSON biçiminde özel anahtar oluşturun ve indirin. Dosyayı service-account.json olarak yeniden adlandırın.
3. Hizmet hesabını Merchant Center'a ekleyin: [e-mail] gibi benzersiz hizmet hesabı e-posta adresini kopyalayın ve Merchant Center'ınıza yeni kullanıcı olarak ekleyin. Daha fazla bilgi için Merchant Center'a kullanıcı ekleme veya kaldırma başlıklı makaleyi inceleyin.
4. Admin erişimi atayın. Erişim düzeyleri hakkında daha fazla bilgi için Merchant Center'da kişiler ve erişim düzeylerini yönetme başlıklı makaleyi inceleyin.
5. Kod örnekleriyle kimlik doğrulamayı ayarlama: Resmi kod örneklerindeki Kimlik Doğrulamayı Ayarlama ve Örnek Yapılandırma dokümanları bölümündeki talimatları uygulayın.

Hizmet hesabı yetkilendirmesi hakkında daha fazla bilgi için Merchant Center hesabınıza erişim yetkisi verme ve Hizmet hesaplarına genel bakış başlıklı makaleleri inceleyin.