Uygulamanızı yapılandırma

Google Fotoğraflar API'lerini kullanmaya başlamak için Google API Konsolu'nu kullanarak ihtiyacınız olan Fotoğraflar API'lerini etkinleştirip bir OAuth 2.0 istemci kimliği oluşturarak projenizi yapılandırın.

Uygulamanız, Google Fotoğraflar kullanıcısı adına Google Fotoğraflar ile etkileşim kurar. Örneğin, bir kullanıcının Google Fotoğraflar kitaplığında albümler oluşturduğunuzda veya medya öğeleri bir kullanıcının Google Fotoğraflar hesabına yüklediğinizde, kullanıcı bu API isteklerini OAuth 2.0 protokolünü kullanarak yetkilendirir.

OAuth 2.0 istemci kimliği, uygulama kullanıcılarınızın oturum açmasına, kimlik doğrulamasına ve böylece Fotoğraflar API'lerini kullanmasına olanak tanır. Fotoğraflar API'leri hizmet hesaplarını desteklemez. Bu API'leri kullanmak için kullanıcıların geçerli bir Google Hesabı'nda oturum açmış olması gerekir.

Uygulamanızı yapılandırma

Önce API'yi etkinleştirin, ardından OAuth 2.0 istemci kimliği isteyin.

API'yi etkinleştirme

Fotoğraflar API'lerini kullanabilmek için projenizde etkinleştirmeniz gerekir.

  1. Google API Konsolu'na gidin.
  2. Menü çubuğundan bir proje seçin veya yeni bir proje oluşturun.
  3. Google Fotoğraflar API'lerinden birini açmak için Gezinme menüsünden API'ler ve Hizmetler > Kitaplık'ı seçin.
  4. "Fotoğraflar" araması yapın. Fotoğraf API'lerinden birini veya daha fazlasını seçip Etkinleştir'i tıklayın.

Google Cloud Console'daki seçici API'lerinin ekran görüntüsü

OAuth 2.0 istemci kimliği isteyin

OAuth istemci kimliği istemek ve bunu uygulamanız için yapılandırmak üzere aşağıdaki adımları uygulayın. Bu örnekte, tüm OAuth akışının sunucu tarafında işlendiği (ör. örneklerimizdeki uygulama) bir uygulama kullanılmaktadır. Kurulum süreci, diğer uygulama senaryoları için değişiklik gösterebilir.

  1. Google API Konsolu'na gidip projenizi seçin.
  2. Menüden API'ler ve Hizmetler > Kimlik Bilgileri'ni seçin.

  3. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayın.

  4. Uygulama türünüzü seçin. Bu örnekte uygulama türü Web uygulamasıdır.

  5. Uygulamanızın Google API'lerine erişmesine izin verilen kaynakları aşağıdaki şekilde kaydedin:

    1. İstemci kimliğini tanımlamak için bir ad girin.

    2. Yetkili JavaScript kaynakları alanına uygulamanızın kaynağını girin. Bu alanda joker karakterlere izin verilmez.

      Uygulamanızın farklı protokoller, alanlar veya alt alanlarda çalışmasına olanak tanımak için birden fazla kaynak girebilirsiniz. Girdiğiniz URL'lerin OAuth isteği başlatmasına izin verilir.

      Aşağıdaki örnekte yerel geliştirme URL'si (örneklerimizde localhost:8080 kullanılmaktadır) ve üretim URL'si gösterilmektedir.

      http://localhost:8080
https://myproductionurl.example.com

    3. Yetkilendirilmiş yönlendirme URI'si alanı, OAuth 2.0 sunucusundan yanıt alan uç noktadır. Genellikle buna geliştirme ortamınız dahildir ve uygulamanızdaki bir yola işaret eder.

      http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback

    4. Oluştur'u tıklayın.

  1. Açılan OAuth istemcisi iletişim kutusunda aşağıdakileri kopyalayın:

    • İstemci Kimliği
    • İstemci gizli anahtarı

    Uygulamanız bu değerleri kullanarak etkin Google API'lerine erişebilir.

Fotoğraflar API'lerine erişen herkese açık bir uygulamayı kullanıma sunmadan önce uygulamanızın Google tarafından incelenmesi gerekir. Uygulamanızı test ettiğinizde, uygulama doğrulanana kadar ekranda "Doğrulanmamış uygulama" mesajı görünür.

Uygulamanızı yapılandırdıktan sonra başlamaya hazırsınız demektir:

İstemci kimliğinizi değiştirme

Google Fotoğraflar API'lerinden herhangi biri aracılığıyla oluşturulan kaynaklara yalnızca oluşturulurken kullanılan orijinal istemci kimliği kullanılarak erişilebilir veya bu kaynaklarda değişiklik yapılabilir. Örneğin, Picker API'de belirli bir istemci kimliğiyle bir "oturum" oluşturur ve daha sonra uygulamanızda bu istemci kimliğini değiştirirseniz uygulamanız, önceki istemci kimliğiyle oluşturulan API kaynaklarına erişimi kaybeder.

Dikkatli bir şekilde plan yapın ve kullandığınız Photos API için doğru istemci kimliği türünü seçin. Erişim sorunlarını önlemek için yalnızca kesinlikle gerekli olduğunda istemci kimliğinizi değiştirin.