OAuth'u ayarlama ve kullanma

Tüm Yerel Hizmetler API çağrıları OAuth 2.0 üzerinden yetkilendirilmelidir. Bu, Local Services API istemci uygulamanızın, kullanıcının giriş bilgilerini işlemesi veya depolaması gerekmeden kullanıcının Yerel Hizmet reklamları hesabına erişmesine olanak tanır.

Yerel Hizmetler API'si, kullanıcıların kimliğini doğrulamak için OAuth 2.0 protokolünü kullanır. OAuth 2.0 hakkında daha fazla bilgi edinmek için Google API'lerine Erişmek İçin OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

Yerel Hizmetler API'si için Google API Konsolu projesi yapılandırma

Google Ads kullanıcılarının kimliğini doğrulamak ve onları yetkilendirmek için Google'ın OAuth 2.0 sunucularına erişim kimlik bilgilerine sahip olmanız gerekir. Bu kimlik bilgileri, uygulamanızı Google'a tanıtır ve Google Ads kullanıcılarını yönetmek için OAuth jetonları oluşturmanıza olanak tanır. Google OAuth 2.0 kimlik bilgilerine erişimi yönetmek için Google API Konsolu'nu kullanın.

Bu kimlik bilgilerini almak için aşağıdaki adımları uygulayın:

  1. Proje oluşturun. Bunu yapmak için Google API Konsolu'na gidin. Proje oluştur'u tıklayın, bir ad girin ve Oluştur'u tıklayın.

  2. Projenizde Yerel Hizmetler API'sini etkinleştirin:

    1. Google API Konsolu'nda API kitaplığını açın. İstenirse projenizi seçin veya yeni bir proje oluşturun. API Kitaplığı'nda, ürün ailesine ve popülerliğe göre gruplandırılmış tüm API'ler listelenir.

      Yerel Hizmetler API'si listede görünmüyorsa bulmak için arama kutusunu kullanın.

    2. Yerel Hizmetler API'sini seçin ve Etkinleştir'i tıklayın.

  3. Bir uygulama türü seçin. Local Services API, Google Ads API ile aynı uygulama türlerini kullanır. Hangi uygulama türünün kullanılacağı hakkında daha fazla bilgi için Uygulama türü seçme başlıklı makaleyi inceleyin.

  4. İstemci kimliği ve istemci gizli anahtarı oluşturun. Yerel Hizmetler API'si için Google Ads API'de kullanılanlarla aynı adımları uygulayarak istemci kimliği ve istemci gizli anahtarı oluşturun. Her iki kullanım alanında da aynı adımlar uygulanır.

OAuth 2.0 jetonları almak için istemci kitaplığını kullanma

OAuth 2.0 yetkilendirme istekleri göndermek için kullanabileceğiniz istemci kitaplıklarının listesini İstemci kitaplıkları bölümünde bulabilirsiniz. Yenileme jetonu kullanarak yeni bir erişim jetonu almayı öğrenmek için kitaplığa özel talimatları uygulayın.

OAuth 2.0 yenileme jetonu edinme

Kullanıcıların kimliğini doğrulamak için üretimdeki istemci kitaplıklarını kullanmanızı öneririz. Test amacıyla bir HTTP istemcisi kullanmak istiyorsanız OAuth 2.0 yenileme jetonu ve erişim jetonu almak için aşağıdaki talimatları uygulayın. 1, 2 ve 3. adımlar, manuel olarak gerçekleştirmeniz gereken tek seferlik kurulum talimatlarıdır. 4 ve 5. adımlar ise daha sonra otomatikleştirilerek insan müdahalesi olmadan (ör. cron işi) çalıştırılabilir.

  1. HTTP web istekleri oluşturmak için kullanılan bir komut satırı aracı olan curl'ü indirip yükleyin.

  2. OAuth Playground sayfasındaki talimatları uygulayarak OAuth 2.0 yenileme jetonu alın. Local Services API için aşağıdaki kapsamı kullanın:

    https://www.googleapis.com/auth/adwords

    Bu, Google Ads API tarafından kullanılan OAuth 2.0 kapsamıyla aynıdır.

    Bu adımın sonunda iki jeton alırsınız: yenileme jetonu ve erişim jetonu. İkisini de kaydedin.

  3. Önceki adımın başarılı olduğunu doğrulamak için komut isteminde aşağıdaki komutu çalıştırın:

    curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>

    Komut çıkışında aşağıdakine benzer bir mesaj gösteriliyorsa işlem başarılı olmuştur:

    {
  "azp": "************-********************************.apps.googleusercontent.com",
  "aud": "************-********************************.apps.googleusercontent.com",
  "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
  "exp": "1611183382",
  "expires_in": "3482",
  "access_type": "offline"
}

    Hata varsa veya kapsam doğru değilse jetonları tekrar oluşturmayı deneyin.

  4. Manuel müdahale olmadan yeni bir erişim jetonu oluşturun. Erişim jetonlarının geçerlilik süresi saatlik olduğundan bu önemlidir. Yenileme jetonlarının geçerlilik süresi çok daha uzun olduğundan, artık gerekmediğinde bunları genellikle manuel olarak iptal etmeniz gerekir.

    Yeni bir erişim jetonu almak için aşağıdaki komutu çalıştırın:

    curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”

  5. Aşağıdaki API çağrısını çalıştırın:

    curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>

    Bu arama başarılı olursa kurulumunuz tamamlanır.