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ığını veya REST'i nasıl yükleyip yapılandıracağınız aşağıda açıklanmıştır.

Ön koşullar

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

Yükleme adımları

Yerel makinenize istediğiniz istemci kitaplığını 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 yerine Google Cloud'unuzun kimliğini yazın.

İsteği göndermek için örneği komut satırına kopyalayın. İşletim hesabına bir iş ortağı bağlantısı üzerinden erişiyorsanız yalnızca Veri iş ortağı örneğini 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ığı yükleme kılavuzundaki talimatları uygulayın.

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

İstemci kitaplığına ek olarak, verileri alım için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını da 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 dotnet run komutunu kullanarak kullanılabilir örneklerin listesini alın.
```
dotnet run
```
Beklenen parametrelerle bir kullanım ifadesi yazdırmak için bir ö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 bazı örnek verilerle birlikte 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

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

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

İstemci kitaplığına ek olarak, verileri biçimlendirme ve şifreleme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını da 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'
```

Başlangıçta yardımcı olması için bazı örnek verilerle birlikte data-manager-samples/src/main/resources/sampledata adresindeki dosyaları kullanın.

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ı yükleyin

İstemci kitaplığına ek olarak, verileri alım için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını da 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 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.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 ö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 bazı örnek verilerle birlikte samples/sampledata adresindeki dosyaları kullanın.

PHP

İstemci kitaplığını yükleme

Projenizde PHP istemci kitaplığı yükleme kılavuzundaki talimatları uygulayarak googleads/data-manager istemci kitaplığına bağımlılık ekleyin.

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

İstemci kitaplığına ek olarak, verileri alım için biçimlendirme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını da 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 ö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
```

Başlangıçta yardımcı olması için bazı örnek verilerle birlikte samples/sampledata adresindeki dosyaları kullanın.

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ı yükleyin

İstemci kitaplığına ek olarak, verileri biçimlendirme ve şifreleme gibi yaygın görevlerde yardımcı olması için yardımcı program kitaplığını da 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
```
Alternatif olarak, yardımcı program kitaplığını doğrudan 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 ö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
```

Başlangıçta yardımcı olması için bazı örnek verilerle birlikte samples/sampledata adresindeki dosyaları kullanın.

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

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ükleyin

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ükleyin

Kod örneklerine göz atma

Node.js

İstemci kitaplığını yükleme

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

Kod örneklerine göz atma

PHP

İstemci kitaplığını yükleme

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

Kod örneklerine göz atma

Python

İstemci kitaplığını yükleme

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

Kod örneklerine göz atma

Ruby

İstemci kitaplığını yükleme

Sonraki adımlar

İstemci kitaplığı yükleme