Bu sayfa, Cloud Translation API ile çevrilmiştir.

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:

Bir Google Cloud projesi.
Google Cloud projenizde serviceusage.services.enable iznine sahip olan veya bu izni içeren bir role sahip bir Google Hesabı. Ö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 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.

Yaygın olarak kullanılan iki kimlik doğrulama yöntemi vardır: Kullanıcı hesapları ve hizmet hesapları.

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 kitaplıklar, uygulamalarınızın kimlik doğrulama ve yetkilendirme işlemlerini yönetmesine olanak tanır. Örneğin, bir uygulamanın Google Cloud kaynaklarına erişmesi gerekiyorsa.

Entegrasyonunuz, kimlik bilgilerini ortamdan otomatik olarak bulmak için Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) kullanabilir. Böylece, kimlik doğrulaması yapmak için istemci kodunu değiştirmeniz gerekmez.

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

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

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

Önemli: Data Manager API kapsamı için kullanıcı kimlik bilgilerini almak üzere kullanılan tüm Google Cloud uygulamaları, kullanıcıları için doğrulanmamış bir kullanıcı arayüzü ekranı gösterilmesini önlemek amacıyla Google OAuth doğrulaması işleminden geçmelidir. Hizmet hesapları için Google OAuth doğrulaması gerekli değildir.
1. Google Cloud Console'da Markalama sayfası'nı açın.
2. Projenizi seçin.
3. Formu doldurun ve Oluştur'u tıklayın.
Veri Yöneticisi 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.
Projede 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.
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ı girin.
```
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"
```
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

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

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

operatingAccount öğesine yerleşik bir ürün bağlantısı kullanarak erişmiyorsanız, destinations öğesindeki girişin linkedAccount özniteliğini 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

İstemci kitaplığını yükleme

Projenize istemci kitaplığına bağımlılık eklemek için .NET istemci kitaplığı yükleme kılavuzundaki talimatları uygulayın.

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

data-manager-dotnet.tar.gz dosyasını indirip ayıklayın.
.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" />
```
Verileri biçimlendirmek için .NET projenizdeki Formatter yardımcı programını kullanın.
samples alt dizinindeki kod örneklerine göz atın.

samples dizinine geçin ve dotnet run komutunu kullanarak kullanılabilir örneklerin listesini alın.
```
dotnet run
```
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 -- ingest-audience-members --help
```
Başlangıçta yardımcı olması için örnek veriler içeren dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

Java

İstemci kitaplığını yükleme

BOM ile Maven kullanıyorsanız pom.xml dosyanıza şunu ekleyin:

  <dependencyManagement>
     <dependencies>
        <dependency>
           <groupId>com.google.cloud</groupId>
           <artifactId>libraries-bom</artifactId>
           <version>26.72.0</version>
           <type>pom</type>
           <scope>import</scope>
        </dependency>
        <dependency>
           <groupId>com.google.api-ads</groupId>
           <artifactId>data-manager-bom</artifactId>
           <version>0.1.0</version>
           <type>pom</type>
           <scope>import</scope>
        </dependency>
     </dependencies>
  </dependencyManagement>

  <dependencies>
     <dependency>
        <groupId>com.google.api-ads</groupId>
        <artifactId>data-manager</artifactId>
     </dependency>
  </dependencies>

Maven'ı BOM olmadan kullanıyorsanız bağımlılıklarınıza şunu ekleyin:

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

Gradle'ı BOM ile kullanıyorsanız bağımlılıklarınıza şunu ekleyin:

  implementation platform('com.google.cloud:libraries-bom:26.72.0')
  implementation platform('com.google.api-ads:data-manager-bom:0.1.0')
  implementation 'com.google.api-ads:data-manager'

Gradle'ı BOM olmadan kullanıyorsanız bağımlılıklarınıza şunu ekleyin:

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

SBT kullanıyorsanız bağımlılıklarınıza şunu ekleyin:

  libraryDependencies += "com.google.api-ads" % "data-manager" % "0.1.0"

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

GitHub deposunu klonlayın.

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

data-manager-java dizinine gidin.
Yardımcı program kitaplığını oluşturup yerel Maven deponuzda yayınlayın.
```
./gradlew data-manager-util:install
```

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

Gradle:

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

Maven:

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

Verileri biçimlendirmek ve şifrelemek için Java projenizdeki UserDataFormatter ve Encrypter yardımcı programlarını kullanın.
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 dosyayı data-manager-samples/src/main/resources/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

Node.js

İstemci kitaplığını yükleme

Projenizde Node.js istemci kitaplığı yükleme kılavuzundaki talimatları uygulayarak @google-ads/datamanager istemci kitaplığına bağımlılık ekleyin.

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

data-manager-node.tar.gz dosyasını indirip ayıklayın.
data-manager-node dizinine gidin.
Bağımlılıkları yüklemek için aşağıdaki komutu çalıştırın.
```
npm install
```
util dizinine geçin.
```
cd util
```
Yardımcı program kitaplığını derleyip npm ile kullanılmak üzere .tgz dosyasına paketlemek için aşağıdaki komutu çalıştırın.
```
npm pack
```
Komut, google-ads-datamanager-util-0.2.0.tgz adlı bir arşiv oluşturur. Sonraki adımlarda kullanabilmek için dosya konumunu not edin.
Node.js projenizde, dependencies dosyasının tam yolu ve dosya adı için bir dependencies girişi ekleyerek Data Manager API yardımcı kitaplığına bağımlılık beyan edin.google-ads-datamanager-util-0.2.0.tgz
```
{
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
      ...
   }
}
```
Verileri biçimlendirmek için Node.js projenizdeki UserDataFormatter yardımcı programını kullanın.
samples alt dizinindeki kod örneklerine göz atın. Aşağıdaki adımları uygulayarak örnekleri çalıştırın:
1. Ayıklanan data-manager-node dizinine gidin.
2. 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.
  
  Örneğin, aşağıdaki komut ingest_audience_members örneğini çalıştırır ve bir kullanım ifadesi yazdırır:
```
npm run ingest-audience-members -w samples -- --help
```
Başlangıçta yardımcı olması için örnek veriler içeren dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

PHP

İstemci kitaplığını yükleme

google-cloud-ads-datamanager-v1-php.tar.gz dosyasını indirip ayıklayın.
google-cloud-ads-datamanager-v1-php dizinine gidin.
Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:
```
composer update --prefer-dist
```
Aynı ana makinedeki PHP projenizin composer.json dosyasında, aşağıdaki adımları kullanarak 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.4"
}
```

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

data-manager-php.tar.gz dosyasını indirip ayıklayın.
data-manager-php dizinine gidin.
Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:
```
composer update --prefer-dist
```
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.
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 dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

Python

İstemci kitaplığını yükleme

Projenizde Python istemci kitaplığı yükleme kılavuzundaki talimatları uygulayarak google-ads-datamanager istemci kitaplığına bağımlılık ekleyin.

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

data-manager-python.tar.gz dosyasını indirip ayıklayın.
data-manager-python dizinine gidin.
Yardımcı program kitaplığını Python ortamınıza yüklemek için aşağıdaki komutu çalıştırın:
```
pip install .
```
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.2.0
```
Verileri biçimlendirmek ve şifrelemek için Python projenizdeki Formatter ve Encrypter yardımcı programlarını kullanın.
samples alt dizinindeki kod örneklerine göz atın. Örnekleri çalıştırmak için gerekli bağımlılıkları yükleyin:
```
pip install .[samples]
```
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 dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

Ruby

İstemci kitaplığını yükleme

Projenizde istemci kitaplığına bağımlılık eklemek için Ruby istemci kitaplığı yükleme kılavuzundaki talimatları uygulayın.

Sonraki adımlar

Kitle verileri gönderme hakkında daha fazla bilgi edinin.
Etkinlik gönderme hakkında daha fazla bilgi edinin.
REST veya RPC referans belgelerine göz atın.

API erişimini ayarlama Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

API'yi etkinleştirme

Kimlik doğrulama ayarlama

İşletme hesabı erişimini ayarlama

Programlama diliniz için SDK'yı ayarlama

REST

.NET

İstemci kitaplığını yükleme

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

Java

İstemci kitaplığını yükleme

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

Node.js

İstemci kitaplığını yükleme

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

PHP

İstemci kitaplığını yükleme

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

Python

İstemci kitaplığını yükleme

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

Ruby

İstemci kitaplığını yükleme

Sonraki adımlar

API erişimini ayarlama