Merchant API için kimlik doğrulama ayarlama

Veri güvenliğini sağlamak, erişim denetimini zorunlu kılmak ve sistem bütünlüğünü korumak için tüm Merchant API isteklerinin kimliğini doğrulamanız gerekir. API, arayanın gerçekleştirmesine izin verilen işlemleri belirlemek için kimliği doğrulanmış kimliği kullanır. Örneğin, bazı arayanlar ürün verilerine salt okuma erişimine sahip olabilirken bazıları Merchant Center'daki hesap ayarlarını değiştirebilir.

Bu belge, Merchant API'yi kullanmaya başlama hakkında çok bölümlü bir serinin parçasıdır. Merchant API ile kimlik doğrulamayı daha önce ayarladıysanız bir sonraki bölüme geçebilirsiniz: Geliştirici olarak kaydolma

Merchant API'ye yönelik istekleri 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ışma şeklinizi en iyi açıklayan kullanım alanına karar verin:

Başka işletmelerin kullanması için bir uygulama mı geliştiriyorsunuz?

Evetse OAuth 2.0 yetkilendirmesini kullanıyorsunuzdur. Aşağıdaki durumlarda OAuth 2.0 yetkilendirmesini seçin:

  • Üçüncü taraf sağlayıcı veya ajanssınız: Diğer işletmelerin kendi Merchant Center verilerini yönetmek için kullanacağı bir uygulama (ör. SaaS platformu) geliştiriyorsunuz.
  • Birçok harici hesabı yönetmeniz gerekiyorsa: Farklı müşterilere ait birden fazla bağımsız Merchant Center hesabında çalışacak tek bir uygulama istiyorsunuz. 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 mi uygulama geliştiriyorsunuz?

Evetse Merchant API erişimi elde etmek için hizmet hesabı yetkilendirmesi kullanıyorsunuzdur. Aşağıdaki durumlarda hizmet hesabı yetkilendirmesini seçin:

  • Kendi şirket içi uygulamanızı geliştiriyorsunuz: Kendi Merchant Center verilerinizi yönetmek için özel olarak kendi işletmeniz için bir araç geliştiriyorsunuz veya kimlik bilgilerinin belirli bir kullanıcıya değil, uygulamanın kendisine ait olmasını istiyorsunuz.
  • İnsan girişi olmadan otomasyona ihtiyacınız var: Uygulamanız, otomatik envanter güncellemeleri veya "cron" işleri gibi arka plan görevleri çalıştırıyor.

OAuth 2.0 yetkilendirmesi

Birden fazla müşteri hesabını yöneten bir üçüncü taraf sağlayıcı veya ajanssanız uygulamanız, istekleri yetkilendirmek için OAuth 2.0 kullanmalıdır. 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 client-secrets.json gibi bir dosyaya indirin.
  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 bulunduğundan emin olun. Daha fazla bilgi için Merchant Center'a kullanıcı ekleme veya kullanıcı 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 kullanıcıları ve erişim düzeylerini yönetme başlıklı makaleyi inceleyin.
  5. Kod örnekleriyle kimlik doğrulama ayarlama: Kimlik Doğrulama ve Örnek Yapılandırma Ayarlama başlıklı resmi kod örnekleri dokümanındaki yönergeleri 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ını yetkilendirme

Merchant API'nin kendi Merchant Center hesabınıza erişimini yetkilendirmek için hizmet hesabı kullanıyorsunuz. 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'de hizmet hesabı kimlik bilgileri oluşturun.
  2. Özel anahtarı indirin: Hizmet hesabı için özel anahtarı JSON biçiminde oluşturup indirin. Dosyayı service-account.json olarak yeniden adlandırın.
  3. Hizmet hesabını Merchant Center'a ekleyin: sa@project.iam.gserviceaccount.com 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 kullanıcı kaldırma başlıklı makaleyi inceleyin.
  4. Admin erişim izni verin. Erişim düzeyleri hakkında daha fazla bilgi için Merchant Center'da kullanıcıları ve erişim düzeylerini yönetme başlıklı makaleyi inceleyin.
  5. Kod örnekleriyle kimlik doğrulama ayarlama: Kimlik Doğrulama ve Örnek Yapılandırma Ayarlama başlıklı resmi kod örnekleri dokümanındaki yönergeleri uygulayın.

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