İ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ığı yüklemeden önce Uygulama Varsayılan Kimlik Bilgileri (ADC)'nin yapılandırılması da dahil olmak üzere API erişimini ayarlama bölümündeki adımları tamamlayın.

Kitaplığı yükleme

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

REST

İzlemek istediğiniz kurulum sürecini seçin:

Reklamveren Veri İş Ortağı

1. Aşağıdaki örnekte yer tutucuları (ör. OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID ve AUDIENCE_ID) hesabınız ve hedefiniz için değerlerle güncelleyin.
2. PROJECT_ID kısmını Google Cloud'unuzun kimliğiyle değiştirin.

3. İsteği göndermek için örneği komut satırına kopyalayı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"
         },
         "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ığında 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 alın.

1. GitHub deposunu klonlayın.

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

2. .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" />
   

3. Verileri biçimlendirmek için .NET projenizdeki Formatter yardımcı programını kullanın.

4. 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 örnek veriler içeren dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

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ı ve kod örneklerini alın.

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

   Maven:

   <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>data-manager-util</artifactId>
      <version>0.2.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 dosyayı data-manager-samples/src/main/resources/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

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ı ve kod örneklerini alın.

1. GitHub deposunu klonlayın.

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

2. data-manager-node dizinine gidin.

3. Bağımlılıkları yüklemek için aşağıdaki komutu çalıştırın.

   npm install
   

4. util dizinine geçin.

   cd util
   

5. Yardımcı program kitaplığını derleyip npm ile kullanılmak üzere .tgz dosyasına paketlemek için aşağıdaki komutu çalıştırın.

   npm pack
   

   Komut, google-ads-datamanager-util-0.2.0.tgz adlı bir arşiv oluşturur. Sonraki adımlarda kullanabilmek için dosya konumunu not edin.

6. Node.js projenizde, dependencies dosyasının tam yolu ve dosya adı için bir dependencies girişi ekleyerek Data Manager API yardımcı kitaplığına bağımlılık beyan edin.google-ads-datamanager-util-0.2.0.tgz

   {
      "dependencies": {
         ...
         "@google-ads/data-manager-util": "file:PATH_TO_UTILITY_LIBRARY/google-ads-datamanager-util-0.2.0.tgz",
         ...
      }
   }
   

   Verileri biçimlendirmek için Node.js projenizdeki UserDataFormatter yardımcı programını kullanın.

7. samples alt dizinindeki veya GitHub'daki kod örneklerine göz atın. Aşağıdaki adımları uygulayarak örnekleri çalıştırın:

   1. data-manager-node dizinine gidin.

   2. 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 örnek veriler içeren dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

PHP

İstemci kitaplığını yükleme

Projenizdeki PHP istemci kitaplığı kurulum kılavuzundaki talimatları uygulayarak projenizdeki googleads/data-manager istemci kitaplığına bağımlılık ekleyin.

İsteğe bağlı: Yardımcı program kitaplığını ve kod örneklerini alın.

1. GitHub deposunu klonlayın.

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

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 veya GitHub'daki kod örneklerine göz atın. Aşağıdaki adımları uygulayarak örnekleri çalıştırın:

   1. samples dizinine gidin.

   2. Kitaplığın bağımlılıklarını çözmek için aşağıdaki komutu çalıştırın:

      composer update --prefer-dist
      

   3. 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 dosyayı samples/sampledata/audience_members_1.csv adresinden indirebilirsiniz.

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ı ve kod örneklerini alın.

1. GitHub deposunu klonlayın.

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

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

5. Verileri biçimlendirmek ve şifrelemek için Python projenizdeki Formatter ve Encrypter yardımcı programlarını kullanın.

6. samples alt dizinindeki veya GitHub'daki 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

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.
• Gönderme etkinlikleri hakkında daha fazla bilgi edinin.
• REST veya RPC referans belgelerine göz atın.

İpucu: Herhangi bir yöntemi denemek için REST referansını ziyaret edin ve yöntemin sayfasındaki araç çubuğunda API düğmesini tıklayın. API Gezgini'ni görüntüleme ve bir yöntemi yürütme başlıklı makaleden daha fazla bilgi edinebilirsiniz.