Yetkilendirme

El değmeden kayıt bayi API'sine yapılan API çağrıları için yetkilendirme gerekir. Yetkilendirme gerektirerek kuruluşunuzun verileri korunur. El değmeden kayıt API'sine çağrıları yetkilendirmek için aşağıdaki görevleri tamamlamanız gerekir:

  1. API'leri çağırmak için bir hizmet hesabı oluşturun.
  2. API çağrılarını yetkilendirmek için JSON anahtar dosyasını depolayın.
  3. Hizmet hesabının kullanımına sunmak için API'yi etkinleştirin.
  4. Kuruluşunuz adına API çağrıları yapmak için hizmet hesabını bağlayın.

Görevleri tamamlamanıza yardımcı olması için aşağıdaki talimatları uygulayın.

1. Adım: Bir hizmet hesabı oluşturun

Bazen robot hesabı olarak adlandırılan hizmet hesabı, kullanıcılar yerine uygulamaları temsil eden bir Google Hesabı'dır. Uygulamanız, hizmet hesabı adına API'leri çağırır. Böylece kullanıcılar doğrudan bu işleme dahil olmaz. Uygulamanız Google API'lerini kullandığından erişimi ayarlamak için Google API Konsolu'nu kullanın.

API Konsolu projesi oluşturma

Uygulamanız için yeni bir API Konsolu projesi ve hizmet hesabı oluşturmak iyi bir uygulamadır. Böylece gelecekte erişimi yönetmeyi, kaynakları yönetmeyi ve kaybolan anahtarları düzeltmeyi kolaylaştırabilirsiniz. Google API Konsolu'nda yeni bir proje oluşturmak için aşağıdaki adımları uygulayarak başlayın:

  1. API Konsolu'na gidin.
  2. Proje listesinden Proje oluştur'u seçin.
  3. Uygulamanızı tanımlayan bir ad ve el değmeden kayıt sürecini girin.
  4. Proje kimliği belirtin veya varsayılanı kabul edin.
  5. Oluştur'u tıklayın.

Daha fazla bilgi edinmek için Konsoldaki projeleri yönetme adlı Google Cloud Platform dokümanını okuyun.

Yeni hizmet kimlik bilgisi ekle

Projenize yeni kimlik bilgileri ve bir hizmet hesabı eklemek için API Konsolunuzda aşağıdaki adımları uygulayın.

  1. Hizmet hesapları sayfasını açın. İstenirse bir proje seçin.
  2. Hizmet Hesabı Oluştur'u tıklayın, hizmet hesabı için bir ad ve açıklama girin. Varsayılan hizmet hesabı kimliğini kullanabilir veya farklı, benzersiz bir tane seçebilirsiniz. Tamamladıktan sonra Oluştur'u tıklayın.
  3. Sonraki Hizmet hesabı izinleri (isteğe bağlı) bölümü gerekli değildir. Devam'ı tıklayın.
  4. Kullanıcıların bu hizmet hesabına erişmelerine izin ver ekranında, Anahtar oluştur bölümüne gidin. Anahtar oluştur'u tıklayın.
  5. Görüntülenen yan panelde anahtar biçimini seçin: JSON önerilir.
  6. Oluştur'u tıklayın. Herkese açık/özel yeni anahtar çiftiniz oluşturulur ve makinenize indirilir; bu anahtarın tek kopyası olarak işlev görür. Güvenli şekilde nasıl depolanacağını öğrenmek için Hizmet hesabı anahtarlarını yönetme konusuna bakın.
  7. Özel anahtar bilgisayarınıza kaydedildi iletişiminde Kapat'ı tıklayın. Ardından hizmet hesapları tablosuna dönmek için Tamam'ı tıklayın.

Hizmet hesabının e-posta adresini kopyalayın ve elinizin altında bulundurun. Hizmet hesabını daha sonra kuruluşunuza bağlarken bu şifreye ihtiyacınız olur.

2. Adım: JSON anahtar dosyasını depolayın

API Konsolu, hizmet hesabınız kullanılarak yapılan API çağrılarının kimliğini doğrulamak için kullanılan yeni bir özel anahtar çifti oluşturur. Özel anahtar, indirdiğiniz JSON anahtar dosyasında bulunur.

Anahtarı gizli tutmanız gerekir, bu nedenle anahtarı uygulamanızın kaynak koduna eklemeyin. Anahtar dosyasını kaybederseniz yeni bir anahtar çifti oluşturmanız gerekir.

Anahtar dosyasını güvenli bir şekilde depolama hakkında daha fazla bilgi için API anahtarlarını güvenli bir şekilde kullanmayla ilgili en iyi uygulamalar konusunu okuyun.

3. Adım: API'yi etkinleştirin

Uygulamanızın API'yi kullanabilmesi için API'yi etkinleştirmeniz gerekir. Bir API etkinleştirildiğinde API, mevcut API Konsolu projesiyle ilişkilendirilir ve konsolunuza izleme sayfaları ekler.

API'yi etkinleştirmek için API Konsolunuzda aşağıdaki adımları uygulayın:

  1. API'ler ve Hizmetler > Kitaplık'ı tıklayın.
  2. Android Cihaz Temel Hazırlık İş Ortağı API'sini bulmak için arama alanını kullanın.
  3. Android Cihaz Temel Hazırlık İş Ortağı API'si seçeneğini tıklayın.
  4. Etkinleştir'i tıklayın.

Kısa bir süre sonra API durumu etkin olarak değişir. Android Cihaz Temel Hazırlığı İş Ortağı API'si seçeneğini görmüyorsanız kuruluşunuzun ilk katılım sürecini manuel olarak gerçekleştirdiğini kontrol edin. El değmeden kayıt ve Google API Konsolu için aynı Google Hesabı'nı kullandığınızdan emin olun. Google Platform Çözümleri Danışmanınızdan Google Hesabınızın API'ya erişimi olup olmadığını kontrol etmesini isteyin.

Hizmet hesabını kuruluşunuzun el değmeden kayıt hesabına bağlamak, hizmet hesabına kuruluşunuz adına API çağrıları yapma yetkisi verir. Hizmet hesabınızı bağlamak için aşağıdaki adımları uygulayın:

  1. El değmeden kayıt portalını açın. Oturum açmanız gerekebilir.
  2. Hizmet hesapları'nı tıklayın.
  3. Hizmet hesabını bağla'yı tıklayın.
  4. E-posta adresini, oluşturduğunuz hizmet hesabının adresine ayarlayın.
  5. Hizmet hesabını el değmeden kayıt hesabınızla kullanmak için Hizmet hesabını bağla'yı tıklayın.

Oluşturduğunuz hizmet hesabının e-posta adresini bulamıyorsanız aşağıdaki yerlerden birinden kopyalayın:

Hizmet hesabınız, kuruluşunuz adına bayi API'sine çağrı yapabilir.

API'yi deneyin

Başlarken bölümündeki adımları uygulayarak API erişiminizin çalışıp çalışmadığını test edin.

Yetkilendirme kapsamları

OAuth 2.0 erişim jetonu istemek için uygulamanızda https://www.googleapis.com/auth/androidworkprovisioning API yetkilendirme kapsamını kullanın.

Kapsam parametresi, bir erişim jetonunun çağrılarına izin verdiği kaynak ve işlemleri kontrol eder. Erişim jetonları yalnızca jeton isteğinin kapsamında açıklanan işlemler ve kaynaklar grubu için geçerlidir. API, el değmeden kayıt kapsamında yukarıda gösterilen tek yöntem ile tüm yöntemleri ve kaynakları kapsar.

Google API istemci kitaplığıyla kullanılan el değmeden kayıt kapsamının bir örneği için Başlayın sayfasına göz atın. Google API kapsamlarını kullanma hakkında daha fazla bilgi edinmek için Google API'lerine Erişmek için OAuth 2.0'ı Kullanma başlıklı makaleyi okuyun.