API erişimini ayarlama

SDK veya REST ile Veri Yöneticisi API'sine erişimi nasıl ayarlayacağınız aşağıda açıklanmıştır.

Ön koşullar

Data API'yi kullanabilmek için aşağıdakilere sahip olduğunuzdan emin olun:

  1. Bir Google Cloud projesi.
  2. Google Cloud projenizde serviceusage.services.enable iznine sahip bir Google Hesabı veya bu izni içeren bir role sahip olmanız gerekir. Örneğin, roles/owner ve roles/serviceusage.serviceUsageAdmin izinlerinin her ikisinde de serviceusage.services.enable izni bulunur. İzinlerinizi kontrol etmek için Mevcut erişimi görüntüleme başlıklı makaleyi inceleyin.

API'yi etkinleştirme

Henüz yapmadıysanız Veri Yöneticisi API'sini etkinleştirin'i tıklayarak Veri Yöneticisi API'sini etkinleştirin veya bu adımı manuel olarak gerçekleştirmek için talimatları uygulayın.

Veri Yöneticisi API'sini etkinleştirme

Veri Yöneticisi API'sini bulamıyorsanız veya Veri Yöneticisi API'sini etkinleştirme işlemi başarısız olursa Google Hesabınızın ön koşulları karşıladığını doğrulayın.

Kimlik doğrulama ayarlama

API anahtarlarının yanı sıra Google'daki kimlik doğrulama yöntemlerinden herhangi birini kullanabilirsiniz. Kullanım alanınıza uygun yaklaşımı belirlemek için Kullanım alanınıza uygun kimlik doğrulama yöntemini seçme başlıklı makaleyi incelemenizi öneririz.

İki yaygın kimlik doğrulama yöntemi kullanıcı hesapları ve hizmet hesaplarıdır:

  • Kullanıcı hesapları: Doğrudan Google API'leri ve hizmetleriyle etkileşim kuran kişileri temsil eder.
  • Hizmet hesapları: Kullanıcı olarak kişileri değil uygulamaları temsil eder. Bu jetonlar, uygulamalarınızın kimlik doğrulama ve yetkilendirmeyi yönetmesine olanak tanır. Örneğin, bir uygulamanın Google Cloud kaynaklarına erişmesi gerekiyorsa.

Entegrasyonunuz, kimlik doğrulamak için istemci kodunu değiştirmeniz gerekmemesi amacıyla ortamdaki kimlik bilgilerini otomatik olarak bulmak için Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanabilir.

ADC'yi ayarlamak için Kullanıcı hesabı veya Hizmet hesabı kimliğine bürünme'yi seçin:

Kullanıcı hesabı kimlik bilgileri ile kimlik doğrulama adımları aşağıda verilmiştir:

  1. Projeniz için Google Auth Platform ayarlarını yapılandırın.

    1. Google Cloud Console'da Markalama sayfası'nı açın.

    2. Projenizi seçin.

    3. Formu doldurun ve Oluştur'u tıklayın.

  2. Data Manager API kapsamı hassas bir kapsam olduğundan aşağıdaki adımlar gereklidir:

    1. Projenizin Veri Erişimi ayarlarına gidin.

    2. Kapsam ekle veya kaldır'ı tıklayın.

    3. Kapsamlar listesinde Veri Yöneticisi API'si'nin yanındaki kutuyu işaretleyin ve Güncelle'yi tıklayın.

    4. Kaydet'i tıklayın.

    5. Google Cloud Console'da Kitle'ye gidin ve Yayınlama durumu ile Kullanıcı türü'nü güncelleyin. Bu ayarlar hakkında daha fazla bilgiyi Uygulama Kitlesini Yönetme başlıklı makalede bulabilirsiniz.

  3. Projeye bir OAuth2 istemcisi oluşturmak için OAuth2 istemcisi oluştur'u tıklayın veya Masaüstü OAuth2 istemcisi oluşturmak için talimatları uygulayın.

    OAuth2 istemcisi oluşturma

    Son adımda İSTEMCİ YAPILANDIRMASINI İNDİR'i tıklayın ve seçtiğiniz indirme konumunu not edin.

  4. Aşağıdaki komutu çalıştırarak yerel bir ADC dosyası oluşturun. Bu komut, API ile kullandığınız Google Hesabı'nda oturum açmanızın istendiği bir web akışı başlatır.

    PATH_TO_CLIENT_JSON yerine indirdiğiniz JSON dosyasının adını yazın.

    gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/datamanager,https://www.googleapis.com/auth/cloud-platform" \
  --client-id-file="PATH_TO_CLIENT_JSON"

  5. Aşağıdaki komutu kullanarak kimlik bilgilerinin doğru şekilde ayarlandığını onaylayın. İşlem başarılı olursa komut, konsola bir erişim jetonu yazdırır.

    gcloud auth application-default print-access-token

Uygulamanızın kimlik doğrulaması ve kimlik bilgileri hakkında daha fazla bilgi edinmek için Google'daki kimlik doğrulama yöntemleri ve Uygulama varsayılan kimlik bilgilerinin işleyiş şekli başlıklı makaleleri inceleyin.

İşletme hesabı erişimini ayarlama

Kullanıcı hesabınızla ilişkili e-posta adresine Destination erişimi verin.

  • Google Ads veya veri iş ortağı hesabı kullanıyorsanız kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.
  • Display & Video 360 hesabı kullanıyorsanız kullanıcının e-posta adresini hesaba eklemek için talimatları uygulayın.

Programlama diliniz için SDK'yı ayarlama

Yerel makinenize istediğiniz SDK'yı yükleyin:

REST

  1. Aşağıdaki örnekteki OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ve AUDIENCE_ID gibi yer tutucuları hesabınız ve hedefiniz için değerlerle güncelleyin.
  2. PROJECT_ID kısmını Google Cloud'unuzun kimliğiyle değiştirin.

  3. İsteği göndermek için örneği komut satırına kopyalayın.

    linkedAccount özelliğini, yerleşik bir ürün bağlantısı kullanarak destinations öğesine erişmiyorsanız operatingAccount öğesindeki girişten kaldırın.

    #!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account, the command that specifies
# --scopes fails. This sample falls back to the command without the
# --scopes argument.
DATA_MANAGER_ACCESS_TOKEN="$(gcloud auth application-default print-access-token --scopes=https://www.googleapis.com/auth/datamanager || \
  gcloud auth application-default print-access-token)"

# Fetches and prints the scope information for the access token. If you
# get scope-related errors when you send the request in the next step,
# verify that this output includes the Data Manager API scope:
#   https://www.googleapis.com/auth/datamanager
curl https://www.googleapis.com/oauth2/v1/tokeninfo?access_token="${DATA_MANAGER_ACCESS_TOKEN}"

# Sends the request.
curl -X POST "https://datamanager.googleapis.com/v1/audienceMembers:ingest" \
  --header "Authorization: Bearer ${DATA_MANAGER_ACCESS_TOKEN}" \
  --header "x-goog-user-project: PROJECT_ID" \
  --header "Content-Type: application/json" \
  --data @- <<EOF
{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "accountType": "LINKED_ACCOUNT_TYPE",
        "accountId": "LINKED_ACCOUNT_ID"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

.NET

  1. google-cloud-ads-datamanager-v1-csharp.tar.gz dosyasını indirip ayıklayın.

  2. .NET projenizde Data Manager API kitaplığına ProjectReference bağımlılık beyan edin. PATH_TO_CLIENT_LIBRARY yerine, google-cloud-ads-datamanager-v1-csharp dizinini google-cloud-ads-datamanager-v1-csharp.tar.gz konumundan çıkardığınız konumu girin.

    <ProjectReference Include="PATH_TO_CLIENT_LIBRARY\Google.Ads.DataManager.V1\Google.Ads.DataManager.V1.csproj" />

  3. İsteğe bağlı. Yardımcı program kitaplığını ve kod örneklerini edinin.

    1. data-manager-dotnet.tar.gz dosyasını indirip ayıklayın.

    2. .NET projenizde, yardımcı kitaplığa ProjectReference bağımlılık bildirin. PATH_TO_UTILITY_LIBRARY yerine, data-manager-dotnet dizinini data-manager-dotnet.tar.gz konumundan çıkardığınız konumu girin.

      <ProjectReference Include="PATH_TO_UTILITY_LIBRARY\Google.Ads.DataManager.Util\src\Google.Ads.DataManager.Util.csproj" />

    3. Verileri biçimlendirmek için .NET projenizdeki Formatter yardımcı programını kullanın.

    4. samples alt dizinindeki kod örneklerine göz atın.

      Kod örneklerini çalıştırmak için DATA_MANAGER_DOTNET_LIB ortam değişkenini google-cloud-ads-datamanager-v1-csharp dizinini google-cloud-ads-datamanager-v1-csharp.tar.gz konumundan çıkardığınız yere ayarlayın.

      export DATA_MANAGER_DOTNET_LIB="PATH_TO_CLIENT_LIBRARY"

      samples dizinine geçin ve dotnet run komutunu kullanarak kullanılabilir örneklerin listesini alın.

      dotnet run --framework net8.0

      Beklenen parametrelerle bir kullanım ifadesi yazdırmak için örnek çalıştırırken --help bağımsız değişkenini iletin.

      dotnet run --framework net8.0 -- ingest-audience-members --help

      Başlangıçta yardımcı olması için örnek veriler içeren samples/sampledata/audience_members_1.csv dosyasını kullanın.

Java

  1. google-cloud-ads-datamanager-v1-java.tar.gz dosyasını indirip ayıklayın.
  2. google-cloud-ads-datamanager-v1-java dizinine gidin.

  3. Kitaplığı Maven veya Gradle ile kullanılmak üzere yerel Maven deponuzda derlemek ve yayınlamak için aşağıdaki komutu çalıştırın.

    ./gradlew install

  4. Java projenizde Data Manager API kitaplığına bağımlılık beyan edin.

    Gradle:

    implementation 'com.google.cloud:gapic-google-cloud-ads-datamanager-v1-java:0.1.3'

    Maven:

    <dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>gapic-google-cloud-ads-datamanager-v1-java</artifactId>
  <version>0.1.3</version>
</dependency>

  5. İsteğe bağlı. Yardımcı program kitaplığını ve kod örneklerini edinin.

    1. GitHub deposunu klonlayın.

      git clone https://github.com/googleads/data-manager-java.git

    2. data-manager-java dizinine gidin.

    3. Yardımcı program kitaplığını oluşturup yerel Maven deponuzda yayınlayın.

      ./gradlew data-manager-util:install

    4. Java projenizde yardımcı program kitaplığına olan bağımlılığı bildirin.

      Gradle:

      implementation 'com.google.api-ads:data-manager-util:0.1.0'

      Maven:

      <dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.0</version>
</dependency>

    5. Verileri biçimlendirmek ve şifrelemek için Java projenizdeki UserDataFormatter ve Encrypter yardımcı programlarını kullanın.

    6. data-manager-samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın. Komut satırından örnek çalıştırmak için Gradle run görevini kullanın.

      Örneğin, aşağıdaki komut IngestAudienceMembers örneğini çalıştırır ve bir kullanım ifadesi yazdırır:

      ./gradlew data-manager-samples:run \
  --args='IngestAudienceMembers --help'

      Başlangıçta yardımcı olması için örnek veriler içeren data-manager-samples/src/main/resources/sampledata/audience_members_1.csv dosyasını kullanın.

Python

  1. ads-datamanager-v1-py.tar.gz dosyasını indirin.
  2. İndirilen dosyanın dizinine gidin.

  3. Kitaplığı oluşturmak ve aynı Python ortamındaki diğer projelerde kullanılabilir hale getirmek için aşağıdaki komutu çalıştırın:

    pip install ./ads-datamanager-v1-py.tar.gz

  4. Python projenizde, Veri Yöneticisi API kitaplığına bağımlılık beyan edin. Örneğin, projenizde requirements.txt dosyası kullanıyorsanız dosyaya aşağıdaki satırı ekleyin:

    google-ads-data-manager=0.1.3

  5. İsteğe bağlı. Yardımcı program kitaplığını ve kod örneklerini edinin.

    1. data-manager-python.tar.gz dosyasını indirip ayıklayın.
    2. data-manager-python dizinine gidin.

    3. Yardımcı program kitaplığını Python ortamınıza yüklemek için aşağıdaki komutu çalıştırın:

      pip install .

    4. Python projenizde yardımcı program kitaplığına bağımlılık bildirin. Örneğin, projenizde requirements.txt dosyası kullanıyorsanız dosyaya aşağıdaki satırı ekleyin:

      google-ads-data-manager-util=0.1.0

    5. Verileri biçimlendirmek ve şifrelemek için Python projenizdeki Formatter ve Encrypter yardımcı programlarını kullanın.

    6. samples alt dizinindeki kod örneklerine göz atın. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için örnek çalıştırırken --help bağımsız değişkenini iletin.

      Başlangıçta yardımcı olması için örnek veriler içeren samples/sampledata/audience_members_1.csv dosyasını kullanın.

Node.js

  1. ads-datamanager-v1-nodejs.tar.gz dosyasını indirip ayıklayın.
  2. ads-datamanager-v1-nodejs dizinine gidin.

  3. Kitaplığı derleyip npm ile kullanılmak üzere .tgz dosyası olarak paketlemek için aşağıdaki komutları çalıştırın.

    npm install
npm pack

    Komutlar, google-cloud-datamanager-0.1.3.tgz adlı bir arşiv oluşturur.

  4. Node.js projenizde, dependencies dosyasının tam yolu ve dosya adı için bir dependencies girişi ekleyerek Data Manager API kitaplığına bağımlılık beyan edin.google-cloud-datamanager-0.1.3.tgz

PHP

  1. google-cloud-ads-datamanager-v1-php.tar.gz dosyasını indirip ayıklayın.
  2. google-cloud-ads-datamanager-v1-php dizinine gidin.

  3. Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:

    composer update --prefer-dist

  4. Aynı ana makinedeki PHP projenizin composer.json dosyasında, aşağıdaki adımları uygulayarak Data Manager API kitaplığına bağımlılık bildirin:

    1. Dizin konumunu gösteren bir repositories bölümü ekleyin.google-cloud-ads-datamanager-v1-php

      "repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_CLIENT_LIBRARY"
   }
]

    2. Veri Yöneticisi API kitaplığına bağımlılık beyan edin.

      "require": {
   "googleads/data-manager": "0.1.3"
}

  5. (İsteğe bağlı) Yardımcı program kitaplığını ve kod örneklerini edinin.

    1. data-manager-php.tar.gz dosyasını indirip ayıklayın.
    2. data-manager-php dizinine gidin.

    3. Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:

      composer update --prefer-dist

    4. Aynı ana makinedeki PHP projenizin composer.json dosyasında, aşağıdaki adımları uygulayarak yardımcı program kitaplığına bağımlılık bildirin:

      1. repositories bölümüne, data-manager-php dizininin konumunu gösteren bir giriş ekleyin.

        "repositories" : [
   {
      "type" : "path",
      "url" : "PATH_TO_UTILITY_LIBRARY"
   }
]

      2. Yardımcı program kitaplığına bağımlılık beyan edin.

        "require": {
   "googleads/data-manager-util": "@dev"
}

      Verileri biçimlendirmek için PHP projenizdeki Formatter yardımcı programını kullanın.

    5. samples alt dizinindeki kod örneklerine göz atın. Aşağıdaki adımları uygulayarak örnekleri çalıştırın:

      1. samples dizinine gidin.

      2. DATA_MANAGER_PHP_LIB ortam değişkenini, istemci kitaplığını çıkardığınız yola ayarlayın.

        export DATA_MANAGER_PHP_LIB="PATH_TO_CLIENT_LIBRARY"

      3. Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:

        composer update --prefer-dist

      4. Gerekli bağımsız değişkenleri ileterek örnekleri çalıştırın. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için örnek çalıştırırken --help bağımsız değişkenini iletin.

      Başlangıçta yardımcı olması için örnek veriler içeren samples/sampledata/audience_members_1.csv dosyasını kullanın.

Sonraki adımlar