REST'i kullanmaya başlayın

Google Photos Library API'yi kullanmaya başlamak için Google API Konsolu üzerinden API'yi etkinleştirip OAuth 2.0 istemci kimliği oluşturarak projenizi yapılandırın.

Uygulamanız, bir Google Fotoğraflar kullanıcısı adına Google Fotoğraflar ile etkileşime geçiyor. Örneğin, bir kullanıcının Google Fotoğraflar kitaplığında albüm oluşturduğunuzda veya kullanıcının Google Fotoğraflar hesabına medya öğeleri yüklediğinizde, kullanıcı bu API isteklerini OAuth 2.0 protokolü aracılığıyla yetkilendirir.

OAuth 2.0 istemci kimliği, uygulama kullanıcılarınızın oturum açmasına, kimlik doğrulaması gerçekleştirmesine ve bu şekilde Library API'yi kullanmasına olanak tanır. Library API, hizmet hesaplarını desteklemez. Bu API'yi kullanmak için kullanıcıların geçerli bir Google Hesabı'nda oturum açmış olması gerekir.

Uygulamanızı yapılandırma

API'yi etkinleştirme

Library API'yi kullanabilmek için önce projenizde etkinleştirmeniz gerekir.

  1. Google API Konsolu'na gidin.
  2. Menü çubuğundan bir proje seçin veya yeni proje oluşturun.
  3. Google API Kitaplığı'nı açmak için Gezinme menüsünden API'ler ve Hizmetler > Kitaplık'ı seçin.
  4. "Google Photos Library API" araması yapın. Doğru sonucu seçin ve Etkinleştir'i tıklayın.

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, örneklerimizde olduğu gibi OAuth akışının tamamının sunucu tarafında işlendiği bir uygulama kullanılmaktadır. Kurulum işlemleri, diğer uygulama senaryolarına göre değişiklik gösterebilir.

  1. Google API Konsolu'na gidin ve 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 izin vermek için birden fazla kaynak girebilirsiniz. Girdiğiniz URL'lerin OAuth isteği başlatmasına izin verilir.

      Aşağıdaki örnekte bir yerel geliştirme URL'si (örneklerimizde localhost:8080 kullanılıyor) ve bir ü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 bu, geliştirme ortamınızı içerir ve uygulamanızdaki bir yolu işaret eder.

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

    4. Create'i (Oluştur) 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.

Library API'ye erişen herkese açık bir uygulamayı başlatabilmeniz için ö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üntülenir.

Örneği deneyin

Artık projenizi Library API ile kullanılacak şekilde yapılandırdığınıza göre GitHub'daki örnek uygulamaya göz atabilirsiniz. Örnek uygulamada, Library API'yi kullanarak nasıl akıllı fotoğraf çerçevesi oluşturacağınızı görebilirsiniz.