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

API erişimini ayarlama

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

Ön koşullar

Veri API'sini kullanabilmeniz için aşağıdakilere sahip olduğunuzdan emin olun:

Bir Google Cloud projesi.
Google Cloud projenizde serviceusage.services.enable iznine sahip bir Google Hesabı veya bu izni içeren bir role sahip. Örneğin, roles/owner ve roles/serviceusage.serviceUsageAdmin her ikisi de serviceusage.services.enable iznini içerir. İ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ştir'e tıklayarak Veri Yöneticisi API'sini etkinleştirin veya bu adımı manuel olarak gerçekleştirmek için talimatları izleyin.

Veri Yöneticisi API'sini bulamazsanız veya Veri Yöneticisi API'sini Etkinleştir başarısız olursa, Google Hesabınızın önkoşulları karşıladığını doğrulayın.

Kimlik doğrulamayı ayarlayın

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ı: Google API'leri ve hizmetleriyle doğrudan etkileşim kuran kişileri temsil eder.
Hizmet hesapları: Kullanıcıları kişiler olarak değil, uygulamalar olarak 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ı için istemci kodunu değiştirmenize gerek kalmaz.

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ğrulaması yapmak için adımlar şunlardır:

Projeniz için Google Auth Platformu 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. Projeniz için 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ştur
Son adımda İSTEMCİ YAPILANDIRMASINI İNDİR'e 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. Başarılı olursa, komut konsola bir erişim belirteci 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.

İşletim hesabı erişimini ayarlayın

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

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

Programlama diliniz için SDK'yı kurun

Yerel makinenize, seçtiğiniz SDK'yı yükleyin:

REST

Aşağıdaki örnekteki OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ve AUDIENCE_ID gibi yer tutucuları, hesabınız ve hedefiniz için olan değerlerle güncelleyin.
PROJECT_ID değerini 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 kütüphanesini ve kod örneklerini edinin.

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 kullanılabilir örneklerin listesini almak için dotnet run kullanı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

google-cloud-ads-datamanager-v1-java.tar.gz dosyasını indirin ve çıkarın.
google-cloud-ads-datamanager-v1-java dizinine gidin.
Kitaplığı Maven veya Gradle ile kullanmak üzere yerel Maven deponuzda derlemek ve yayınlamak için aşağıdaki komutu çalıştırın.
```
./gradlew install
```

Java projenizde, Veri Yöneticisi API kütüphanesine bir bağımlılık bildirin.

Gradle:

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

Usta:

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

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

GitHub deposunu kopyalayın.

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

data-manager-java dizinine gidin.
Yardımcı program kütüphanesini oluşturun ve 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.1.0'

Maven:

<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>data-manager-util</artifactId>
   <version>0.1.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 bir örneği ç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

ads-datamanager-v1-nodejs.tar.gz dosyasını indirin ve çıkarın.
ads-datamanager-v1-nodejs dizinine gidin.
İstemci kitaplığını npm ile kullanılmak üzere bir .tgz dosyasına derlemek ve paketlemek için aşağıdaki komutu çalıştırın.
```
npm pack
```
Komut google-cloud-datamanager-0.1.4.tgz adında bir arşiv oluşturur. Dosya konumunu not edin, böylece sonraki adımlarda kullanabilirsiniz.
Node.js projenizde, google-cloud-datamanager-0.1.4.tgz dosyasının tam yolu ve dosya adı için dependencies girişi ekleyerek Veri Yöneticisi API istemci kitaplığına bir bağımlılık bildirin.
```
{
   "dependencies": {
      ...
      "@google-cloud/datamanager": "file:PATH_TO_CLIENT_LIBRARY/google-cloud-datamanager-0.1.4.tgz",
      ...
   }
}
```

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

data-manager-node.tar.gz dosyasını indirin ve çıkarın.
data-manager-node dizinine gidin.
util dizinine geçin.
```
cd util
```
npm ile kullanılmak üzere yardımcı program kitaplığını bir .tgz dosyasına derlemek ve paketlemek için aşağıdaki komutu çalıştırın.
```
npm pack
```
Komut google-ads-datamanager-util-0.1.0.tgz adında bir arşiv oluşturur. Dosya konumunu not edin, böylece sonraki adımlarda kullanabilirsiniz.
Node.js projenizde, google-ads-datamanager-util-0.1.0.tgz dosyasının tam yolu ve dosya adı için dependencies girişi ekleyerek Veri Yöneticisi API yardımcı programı kitaplığına bir bağımlılık bildirin.
```
{
   "dependencies": {
      ...
      "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.1.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. Örnekleri aşağıdaki adımları kullanarak çalıştırın:
1. google-cloud-datamanager-0.1.4.tgz dosyasını data-manager-node dizininin üst dizinine kopyalayın.
2. data-manager-node altındaki samples dizinine gidin.
3. Örnekleri derlemek için aşağıdaki komutu çalıştırın.
```
npm run compile
```
4. Örnekleri çalıştırın ve gerekli tüm argümanları iletin. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir örnek çalıştırırken --help argümanını geçirin.
  
  Örneğin, aşağıdaki komut ingest_audience_members örneğini çalıştırır ve bir kullanım ifadesi yazdırır:
```
npx ts-node audiences/ingest_audience_members.ts --help
```
Bazı örnek verilerle başlamanıza yardımcı olması için samples/sampledata/audience_members_1.csv adresindeki dosyayı kullanın.

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ı sunucudaki PHP projenizin composer.json dosyasında, aşağıdaki adımları kullanarak Veri Yöneticisi API kitaplığına bir bağımlılık bildirin:
1. google-cloud-ads-datamanager-v1-php dizininin konumunu gösteren bir repositories bölümü ekleyin.
```
"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 kütüphanesini ve kod örneklerini edinin.

data-manager-php.tar.gz dosyasını indirin ve çıkarı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ı sunucudaki PHP projenizin composer.json dosyasında, aşağıdaki adımları kullanarak yardımcı program kitaplığına bir 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 kütüphanesine bir bağımlılık bildirin.
```
"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. Örnekleri aşağıdaki adımları kullanarak ç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. Kütüphaneye ilişkin bağımlılıkları çözmek için aşağıdaki komutu çalıştırın:
```
composer update --prefer-dist
```
4. Örnekleri çalıştırın ve gerekli tüm argümanları iletin. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir örnek çalıştırırken --help argümanını geçirin.
Bazı örnek verilerle başlamanıza yardımcı olması için samples/sampledata/audience_members_1.csv adresindeki dosyayı kullanın.

Python

İstemci kitaplığını yükleme

Projenizdeki google-ads-datamanager istemci kitaplığına bir bağımlılık eklemek için Python istemci kitaplığı kurulum kılavuzundaki talimatları izleyin.

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

data-manager-python.tar.gz dosyasını indirin ve çıkarı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

Projenizdeki istemci kitaplığına bir bağımlılık eklemek için Ruby istemci kitaplığı kurulum kılavuzundaki talimatları izleyin.

Sonraki adımlar

Hedef kitle verilerini 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ğrulamayı ayarlayın

İşletim hesabı erişimini ayarlayın

Programlama diliniz için SDK'yı kurun

REST

.NET

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

Java

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

Node.js

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

PHP

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

Python

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kütüphanesini ve kod örneklerini edinin.

Ruby

İstemci kitaplığını yükleme

Sonraki adımlar

API erişimini ayarlama