Yetkilendirme

El değmeden kayıt müşteri API'sine yapılan API çağrıları için yetkilendirme gerekir. Yetkilendirme isteme işlemi kuruluşunuzun verilerini korur. El değmeden kayıt API'sine yapılan ç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. Hizmetin kullanımına sunmak için API'yi etkinleştirin hesap.
  4. Sizin adınıza API çağrıları yapmak için hizmet hesabını bağlayın kurum içinde tutmaktır.

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

1. Adım: Hizmet hesabı oluşturun

Bazen robot hesabı olarak da adlandırılan hizmet hesabı, bir Google Hesabı'dır temsil eder. Uygulamanız, API'leri hizmet hesabı adına çağırır. Bu nedenle kullanıcılar bu işleme doğrudan dahil olmaz. Çünkü uygulamanızda Google API'leri varsa 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. Bu, erişimi, kaynakları ve kayıp anahtarları yönetmeyi gelecekte daha kolay hale getirir. Aşağıdaki adımları izleyerek Google API Konsolu'ndaki yeni bir proje:

  1. API Konsolu'na gidin.
  2. Projeler listesinden Proje oluşturun.
  3. Uygulamanızı ve el değmeden kayıt özelliğini açıklayan bir ad girin.
  4. Bir proje kimliği belirtin veya varsayılan değeri kabul edin.
  5. Oluştur'u tıklayın.

Daha fazla bilgi edinmek için Konsolda projeleri yönetme başlıklı Google Cloud Platform belgesini okuyun.

Yeni hizmet kimlik bilgileri ekleyin

Projenize yeni kimlik bilgileri ve hizmet hesabı eklemek için adımları uygulayın 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. Daha sonra hizmet hesabını kuruluşunuza bağlarken bu anahtara ihtiyacınız olur.

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

API Console, 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 JSON anahtarındadır olduğunu unutmayın.

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

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

Uygulamanızın API'yi kullanabilmesi için öncelikle etkinleştirmeniz gerekir. Bir API'yi etkinleştirmek, API'yi mevcut API Konsolu projesiyle ilişkilendirir 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 Hazırlama İş Ortağı API'sini bulmak için arama alanını kullanın.
  3. Android Cihaz Temel Hazırlık İş Ortağı API'sı 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. Bu Android Cihaz Temel Hazırlık İş Ortağı API'si, kuruluşunuzun programa dahil olup olmadığını kontrol edin el değmeden kayıt sürecine dahil oluyor. Şu hesap için aynı Google Hesabı'nı kullandığınızdan emin olun: El değmeden kayıt ve Google API Konsolu.

Hizmet hesabını kuruluşunuzun el değmeden kayıt özelliğine bağlama hesabı, hizmet hesabına sizin adınıza API çağrıları yapma yetkisi verdiğinde kurum içinde tutmaktır. Hizmet hesabınızı bağlamak için bağlantı istek formunu doldurun.

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

  • Şuradaki Hizmet hesabı e-postası: Hizmet hesapları sayfası'nı açın.
  • JSON anahtar dosyasındaki client_email mülk alanı.

Hesabınızın bağlandığına dair e-posta onayı aldıktan sonra hizmet hesabınız, kuruluşunuz adına müşteri API'sine çağrı gönderebilir.

API'yi deneme

Aşağıdaki uygulamalardan birindeki adımları uygulayarak API erişiminizin çalışıp çalışmadığını test edin: için hızlı başlangıç kılavuzları Java, .NET ve Python.

Yetkilendirme kapsamları

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

Kapsam parametresi, belirli bir erişime sahip olan çağrıya izin verir. Erişim jetonları yalnızca jeton isteği kapsamında açıklanan işlemler ve kaynaklar için geçerlidir. API, yukarıda gösterilen tek bir el değmeden kayıt kapsamıyla tüm yöntemleri ve kaynakları kapsar.

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.