API erişimini ayarlama

REST

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

   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": {
           "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": [
       {
         "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. 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.

   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 samples/sampledata/audience_members_1.csv dosyasını kullanın.

Java

İstemci kitaplığını yükleme

1. google-cloud-ads-datamanager-v1-java.tar.gz dosyasını indirip ayıklayın.
2. google-cloud-ads-datamanager-v1-java dizinine gidin.

3. Kitaplığı Maven veya Gradle ile kullanmak üzere yerel Maven deponuzda derlemek ve yayınlamak için aşağıdaki komutu çalıştırın.

   ./gradlew install
   

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

   Maven:

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

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

Node.js

İstemci kitaplığını yükleme

1. ads-datamanager-v1-nodejs.tar.gz dosyasını indirip ayıklayın.
2. ads-datamanager-v1-nodejs dizinine gidin.

3. İstemci 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-cloud-datamanager-0.1.4.tgz adlı bir arşiv oluşturur. Sonraki adımlarda kullanabilmek için dosya konumunu not edin.

4. Node.js projenizde, dependencies dosyasının tam yolu ve dosya adı için bir google-cloud-datamanager-0.1.4.tgz girişi ekleyerek Data Manager API istemci kitaplığına bağımlılık beyan edin.

   {
      "dependencies": {
         ...
         "@google-cloud/datamanager": "file:PATH_TO_CLIENT_LIBRARY/google-cloud-datamanager-0.1.4.tgz",
         ...
      }
   }
   

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

1. data-manager-node.tar.gz dosyasını indirip ayıklayın.
2. data-manager-node dizinine gidin.

3. util dizinine geçin.

   cd util
   

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

   npm pack
   

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

5. 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.1.0.tgz

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

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

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

   1. google-cloud-datamanager-0.1.4.tgz dosyasını data-manager-node dizininin üst dizinine kopyalayın.

   2. data-manager-node altında samples dizinine gidin.

   3. Örnekleri derlemek için aşağıdaki komutu çalıştırın.

      npm run compile
      

   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.

      Örneğin, aşağıdaki komut ingest_audience_members örneğini çalıştırır ve bir kullanım ifadesi yazdırır:

      npx ts-node audiences/ingest_audience_members.ts --help
      

   Başlangıçta yardımcı olması için örnek veriler içeren samples/sampledata/audience_members_1.csv dosyasını kullanın.

PHP

İstemci kitaplığını yükleme

1. google-cloud-ads-datamanager-v1-php.tar.gz dosyasını indirip ayıklayın.
2. google-cloud-ads-datamanager-v1-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 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.4"
      }
      

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

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.

Python

İstemci kitaplığını yükleme

1. ads-datamanager-v1-py.tar.gz dosyasını indirin.
2. İndirilen dosyanın dizinine gidin.

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

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

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

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.

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.