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 (ADC) yapılandırma da yer alır.

Yükleme adımları

Yerel makinenizde, istediğiniz istemci kitaplığını 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. İşletme hesabına bir iş ortağı bağlantısı üzerinden erişiyorsanız yalnızca Veri iş ortağı örneğini kullanın. Aksi takdirde, Advertiser ö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

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 edinin.

GitHub deposunu klonlayın.

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

.NET projenizde, yardımcı kitaplığa ProjectReference bağımlılık beyan edin. PATH_TO_UTILITY_LIBRARY kısmını, data-manager-dotnet deposunu klonladığınız konumla değiştirin.
```
<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 veya GitHub'daki 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 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:

v0.4.0 etiketindeki GitHub deposunu 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

Projenize 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:

v0.4.1 etiketindeki GitHub deposunu 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:

v0.4.0 etiketindeki GitHub deposunu 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
```
İsterseniz 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

v0.4.0 etiketindeki GitHub deposunu 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

Projenize istemci kitaplığı bağımlılığı 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ı ve kod örneklerini edinin.

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