The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out this form.

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.
Aşağıdaki ölçütlerin her ikisini de karşılayan bir Google Hesabı:
1. Data Manager API İlgi Alanı Formu'nu doldurduktan sonra Data Manager API'ye erişim izni verilmiş olmalıdır. API ürün ayrıntıları sayfasını görüyorsanız erişiminiz var demektir.
2. Google Cloud projenizde serviceusage.services.enable iznine veya bu izni içeren bir role sahip olmalıdır. Ö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.

Veri Yöneticisi API'sini bulamıyorsanız Google Hesabınızın ön koşulları karşıladığını doğrulayın.

Kimlik doğrulama ayarlama

Bir kimlik doğrulama yöntemi seçip ayarlayın. Ortamdaki kimlik bilgilerini otomatik olarak bulmak için Uygulama Varsayılan Kimlik Bilgileri'ni ayarlamanızı öneririz. Bu API, API anahtarlarını kullanmaz.

Veri Yöneticisi API'si ile kullanılan tüm kimlik bilgileri için https://www.googleapis.com/auth/datamanager kapsamı gerekir. Kapsamların nasıl kullanılacağına dair bir örnek için gcloud auth application-default login komutunun dokümanlarına bakın.

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ı veya hizmet hesabınızla ilişkili e-posta adresine Destination erişimi verin.

Programlama diliniz için SDK'yı ayarlama

Yerel makinenize istediğ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 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.

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": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },
      "loginAccount": {
        "product": "LOGIN_ACCOUNT_PRODUCT",
        "accountId": "LOGIN_ACCOUNT_ID"
      },
      "linkedAccount": {
        "product": "LINKED_ACCOUNT_PRODUCT",
        "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

google-cloud-ads-datamanager-v1-csharp.tar.gz dosyasını indirip ayıklayın.
.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" />
```
İ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

google-cloud-ads-datamanager-v1-java.tar.gz dosyasını indirip ayıklayın.
google-cloud-ads-datamanager-v1-java dizinine gidin.
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 -Pversion=0.1.0 install
```

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.0'

Maven:

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

İ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

ads-datamanager-v1-py.tar.gz dosyasını indirin.
İndirilenler dizinine gidin.
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
```
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.0
```
İ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

ads-datamanager-v1-nodejs.tar.gz dosyasını indirip ayıklayın.
ads-datamanager-v1-nodejs dizinine gidin.
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.0.tgz adlı bir arşiv oluşturur.
Node.js projenizde, dependencies dosyasının tam yolu ve dosya adı için bir google-cloud-datamanager-0.1.0.tgz girişi ekleyerek Data Manager API kitaplığına bağımlılık beyan edin.

PHP

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ı 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.0"
}
```
(İ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

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.