Başlayın

Bayilerin Ortak Android Bayi Kitaplığı'nı kullanmadan önce Samsung'un Knox Dağıtım Programı ve Android el değmeden kayıt sürecine katılmaları gerekir.

Knox Dağıtım Programı (KDP)

KDP'ye katılmak için aşağıdaki adımları uygulayın ve bayi kitaplığını kullanmaya başlamak için gerekli ayrıntıları alın.

1. Adım: KDP'ye kaydolun

1. KDP'ye kaydolmak üzere Bayiler için Samsung Knox sayfasını ziyaret edin.
2. Bir Samsung hesabı oluşturun ve bayi olarak bir Samsung Knox hesabına kaydolun.
3. Bayi hesabınız onaylandıktan sonra resellerId öğenizi bulmak için KDP portalına giriş yapın.

2. Adım: Knox Cloud API Portalı'na erişim isteyin

1. Knox Cloud API Portalı'na erişmek için Samsung'a istek gönderin.
2. Knox Cloud API Portalı'na giriş yapın.

3. Adım: Hizmet hesabı anahtarlarını ve clientIdentifier edinin

1. Anahtar çifti JSON dosyasını Knox Cloud API portalından indirin ve güvenli bir yerde saklayın.
2. Knox Cloud API portalından benzersiz clientIdentifier oluşturun.

4. adım: SamsungResellerService nesnesini oluşturma

Ortak kitaplık kullanmak üzere SamsungResellerService nesnesi oluşturmak için clientIdentifier, resellerId JSON dosya yolunu kullanın.

Zero-touch kayıt

1. Adım: El değmeden kayıt programına katılın

1. El değmeden kayıt sürecini başlatın.
2. Ortak Android Bayi Kitaplığı Reseller API'yi kullandığından Google Platform Çözüm Danışmanınızdan Bayi API'sine erişim isteğinde bulunmanız gerekir.
3. El değmeden kayıt portalına erişim isteyin.

Portala erişmek için kullandığınız Google Hesabı ile hizmet hesabını oluşturmak ve Reseller API'yi etkinleştirmek için kalan talimatları uygulayın.

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

Bazen robot hesabı olarak bilinen hizmet hesabı, kullanıcılar yerine uygulamaları temsil eden bir Google Hesabıdır. Kayıt kitaplığı, Google API'leri hizmet hesabı adına çağırdığından erişimi ayarlamak için Google API Konsolu'nu kullanın.

API Konsolu projesi oluşturma

Yeni bir API Konsolu projesi ve hizmet hesabı oluşturmak iyi bir uygulamadır. Böylece erişimi yönetme, kaynakları yönetme ve kayıp anahtarları düzeltme işlemlerini gelecekte daha kolay hale getirebilirsiniz. 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ı ve el değmeden kayıt sürecinizi açıklayan bir ad girin.
4. Bir proje kimliği belirtin veya varsayılanı kabul edin.
5. Oluştur'u tıklayın.

Daha fazla bilgi edinmek için Projeleri konsoldan yönetme başlıklı Google Cloud Platform dokümanını okuyun.

Yeni hizmet kimlik bilgisi ekle

Projenize yeni kimlik bilgileri ve 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ı kuruluşunuza daha sonra bağladığınızda bu özellik gereklidir.

3. 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, dolayısıyla anahtarınızı kaynak kodunuza 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 edinmek için API anahtarlarını güvenli bir şekilde kullanmaya yönelik en iyi uygulamalar başlıklı makaleyi okuyun.

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

Kitaplık, Reseller API'yi kullanabilmek için önce etkinleştirmeniz gerekir. Bir API etkinleştirildiğinde API, mevcut API Konsolu projesiyle ilişkilendirilir ve konsolunuza izleme sayfaları eklenir.

Reseller 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 gecikmenin ardından API durumu etkin olarak değişir. Android Cihaz Temel Hazırlık İş Ortağı API'sini görmüyorsanız kuruluşunuzun el değmeden kayıt sürecine dahil olup olmadığını 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'ye erişimi olup olmadığını kontrol etmesini isteyin.

5. Adım: Hizmet hesabını bağlayın

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 adresi'ni, oluşturduğunuz hizmet hesabının adresi olarak 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 konumlardan birinden kopyalayın:

• Google API Konsolu'ndaki Hizmet hesapları sayfasından alınan hizmet hesabı kimliği.
• JSON anahtar dosyasındaki client_email özellik alanı.

Artık ResellerService nesne oluşturmak için hizmet hesabınızı kayıt kitaplığıyla kullanabilirsiniz.

Ortak Android Bayi Kitaplığı'nı Gradle projesine ekleme

Kitaplık, Maven deposu olarak kullanılabilir. Kitaplığı yeni bir Gradle projesine eklemek için aşağıdaki adımları uygulayın:

1. Yeni bir proje oluşturmak için aşağıdaki komutu çalıştırın:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. 2. adımda indirdiğiniz service_account_key.json dosyasını yukarıda oluşturduğunuz src/main/resources/ dizinine kopyalayın.

3. Varsayılan build.gradle dosyasını açın ve derlemeniz için merkezi Maven deposunu bildirin:

   repositories {
       mavenCentral()
   }
   

4. Aynı dosyada aşağıdaki bağımlıyı ekleyin:

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

Projenizin artık Android cihazları kaydettirmek için istemci kitaplığını kullanabilmesi gerekir.

---

Sonraki adımlar: Genel işlemler