Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

İstemci kitaplığı yükleme

İstemci kitaplığı veya REST'i nasıl yükleyip yapılandıracağınız aşağıda açıklanmıştır.

Ön koşullar

İstemci kitaplığını yüklemeden önce API erişimini ayarlama bölümündeki adımları tamamlayın. Bu adımlara Uygulama Varsayılan Kimlik Bilgileri'ni (ADC) yapılandırma da dahildir.

Yükleme adımları

Yerel makinenize istediğiniz istemci kitaplığını yükleyin:

REST

Aşağıdaki örnekte yer alan OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ve AUDIENCE_ID gibi yer tutucuları hesabınızın ve hedefinizin değerleriyle güncelleyin.
PROJECT_ID yerine Google Cloud kimliğinizi yazın.

İsteği göndermek için örneği komut satırına kopyalayın. Veri iş ortağı örneğini yalnızca işletme hesabına bir iş ortağı bağlantısı üzerinden erişiyorsanız kullanın. Aksi takdirde Reklamveren örneğini kullanın.

Reklamveren

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
            },
            {
              "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
            }
          ]
        }
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
EOF

Veri iş ortağı

#!/bin/bash

# Uses gcloud to get an access token. If the Application Default
# Credentials aren't for a service account then the command that
# specifies --scopes fails, so 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": [
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
            },
            {
              "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
            },
            {
              "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
            },
            {
              "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "userData": {
          "userIdentifiers": [
            {
              "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
            },
            {
              "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
            }
          ]
        }
      }
    },
    {
      "compositeData": {
        "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

Projenizdeki istemci kitaplığına bağımlılık eklemek için .NET istemci kitaplığı kurulum kılavuzundaki talimatları uygulayın.

İsteğe bağlı: Yardımcı program kitaplığını yükleme

İstemci kitaplığına ek olarak, verileri besleme için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını yükleyebilirsiniz.

.NET projenizde Google.Ads.DataManager.Util yardımcı program kitaplığına bağımlılık bildirin.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
Verileri biçimlendirmek için .NET projenizdeki UserDataFormatter yardımcı programını kullanın.

Kod örneklerine göz atma

samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın.

Örnekleri çalıştırmak için:

GitHub deposunu v0.4.0 etiketinde klonlayın:

git clone --branch v0.4.0 https://github.com/googleads/data-manager-dotnet.git

data-manager-dotnet dizinine gidin.
samples dizinine geçin ve mevcut örneklerin listesini almak için dotnet run komutunu 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
```

Örnek verilerle çalışmaya başlamak için samples/sampledata adresindeki dosyaları kullanın.

Go

İstemci kitaplığını yükleme

go get cloud.google.com/go/datamanager/apiv1@latest

Daha fazla bilgi için Go istemci kitaplığı kılavuzundaki talimatları uygulayın.

Java

İstemci kitaplığını yükleme

Projenizdeki istemci kitaplığına bağımlılık eklemek için Java istemci kitaplığı kurulum kılavuzundaki talimatları uygulayın.

İsteğe bağlı: Yardımcı program kitaplığını yükleme

İstemci kitaplığına ek olarak, verileri besleme için biçimlendirme ve şifreleme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını yükleyebilirsiniz.

Java projenizde data-manager-util yardımcı program kitaplığına bağımlılık bildirin.

Gradle:

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

Maven:

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

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

Kod örneklerine göz atma

data-manager-samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın.

Örnekleri çalıştırmak için:

GitHub deposunu v0.4.0 etiketinde klonlayın:

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

data-manager-java dizinine gidin.
Gerekli bağımsız değişkenleri ileterek Gradle run görevini kullanarak örnekleri komut satırından ç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 IngestAudienceMembers örneğini çalıştırır ve bir kullanım ifadesi yazdırır:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

Örnek verilerle çalışmaya başlamak için data-manager-samples/src/main/resources/sampledata adresindeki dosyaları kullanın.

Node.js

İstemci kitaplığını yükleme

Projenizdeki @google-ads/datamanager istemci kitaplığına bağımlılık eklemek için Node.js istemci kitaplığı kurulum kılavuzundaki talimatları uygulayın.

İsteğe bağlı: Yardımcı program kitaplığını yükleme

İstemci kitaplığına ek olarak, verileri besleme için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını yükleyebilirsiniz.

Node.js projenizde @google-ads/datamanager-util yardımcı program kitaplığına bağımlılık bildirin:
```
npm install @google-ads/datamanager-util
```
Verileri biçimlendirmek için Node.js projenizde UserDataFormatter yardımcı programını kullanın.

Kod örneklerine göz atma

samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın.

Örnekleri çalıştırmak için:

GitHub deposunu v0.4.1 etiketinde klonlayın:

git clone --branch v0.4.1 https://github.com/googleads/data-manager-node.git

data-manager-node dizinine gidin.
Örnekleri çalıştırmak için bağımlılıkları yükleyin:
```
npm install
```
Gerekli bağımsız değişkenleri ileterek örnekleri çalıştırın. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir ö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
```

Örnek verilerle çalışmaya başlamak için samples/sampledata adresindeki dosyaları kullanın.

PHP

İstemci kitaplığını yükleme

Projenizdeki googleads/data-manager istemci kitaplığına bağımlılık eklemek için PHP istemci kitaplığı kurulum kılavuzundaki talimatları uygulayın.

İsteğe bağlı: Yardımcı program kitaplığını yükleme

İstemci kitaplığına ek olarak, verileri besleme için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını yükleyebilirsiniz.

Aynı ana makinedeki PHP projenizin composer.json dosyasında, yardımcı program kitaplığına bağımlılık bildirin:
```
composer require googleads/data-manager-util
```
Verileri biçimlendirmek için PHP projenizdeki Formatter yardımcı programını kullanın.

Kod örneklerine göz atma

samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın.

Örnekleri çalıştırmak için:

GitHub deposunu v0.4.0 etiketinde klonlayın:

git clone --branch v0.4.0 https://github.com/googleads/data-manager-php.git

data-manager-php/samples dizinine gidin.
Örnekleri çalıştırmak için bağımlılıkları yükleyin:
```
composer install
```
Gerekli bağımsız değişkenleri ileterek örnekleri çalıştırın. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir ö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:
```
php audiences/ingest_audience_members.php --help
```

Örnek verilerle çalışmaya başlamak için samples/sampledata adresindeki dosyaları kullanın.

Python

İstemci kitaplığını yükleme

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

İsteğe bağlı: Yardımcı program kitaplığını yükleme

İstemci kitaplığına ek olarak, verileri besleme için biçimlendirme ve şifreleme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını yükleyebilirsiniz.

Python projenizde google-ads-datamanager-util 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-datamanager-util==0.4.0
```
Dilerseniz yardımcı program kitaplığını doğrudan da yükleyebilirsiniz:
```
pip install google-ads-datamanager-util==0.4.0
```
Verileri biçimlendirmek ve şifrelemek için Python projenizdeki Formatter ve Encrypter yardımcı programlarını kullanın.

Kod örneklerine göz atma

GitHub deposunu v0.4.0 etiketinde klonlayın:

git clone --branch v0.4.0 https://github.com/googleads/data-manager-python.git

data-manager-python dizinine gidin.
Örnekleri çalıştırmak için bağımlılıkları yükleyin:
```
pip install -r samples/requirements.txt
```
Gerekli bağımsız değişkenleri ileterek örnekleri çalıştırın. Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir ö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:
```
python3 samples/audiences/ingest_audience_members.py --help
```

Örnek verilerle çalışmaya başlamak için samples/sampledata adresindeki dosyaları kullanın.

Ruby

İstemci kitaplığını yükleme

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

Sonraki adımlar

Kitle verilerini gönderme hakkında daha fazla bilgi edinin.
Etkinlik gönderme hakkında daha fazla bilgi edinin.
Entegrasyonunuzu üretime nasıl dağıtacağınızı öğrenin.
REST veya RPC referans belgelerine göz atın.

API erişimini ayarlama

Ajan becerileri

İstemci kitaplığı yükleme Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Ön koşullar

Yükleme adımları

REST

Reklamveren

Veri iş ortağı

.NET

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kitaplığını yükleme

Kod örneklerine göz atma

Go

İstemci kitaplığını yükleme

Java

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kitaplığını yükleme

Kod örneklerine göz atma

Node.js

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kitaplığını yükleme

Kod örneklerine göz atma

PHP

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kitaplığını yükleme

Kod örneklerine göz atma

Python

İstemci kitaplığını yükleme

İsteğe bağlı: Yardımcı program kitaplığını yükleme

Kod örneklerine göz atma

Ruby

İstemci kitaplığını yükleme

Sonraki adımlar

İstemci kitaplığı yükleme