‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

התקנה של ספריית לקוח

כך מתקינים ומגדירים ספריית לקוח או REST.

דרישות מוקדמות

לפני שמתקינים ספריית לקוח, צריך לבצע את השלבים שמפורטים במאמר הגדרת הגישה ל-API, כולל הגדרת Application Default Credentials ‏ (ADC).

שלבי ההתקנה

במחשב המקומי, מתקינים את ספריית הלקוח הרצויה:

REST

מעדכנים את ה-placeholders בדוגמה הבאה, כמו OPERATING_ACCOUNT_PRODUCT,‏ OPERATING_ACCOUNT_ID ו-AUDIENCE_ID, בערכים של החשבון והיעד שלכם.
מחליפים את PROJECT_ID במזהה הפרויקט ב-Google Cloud.

מעתיקים את הדוגמה לשורת הפקודה כדי לשלוח את הבקשה. השתמשו בדוגמה של שותף נתונים רק אם אתם ניגשים לחשבון התפעולי דרך קישור של שותף. אחרת, משתמשים בדוגמה של מפרסם.

מפרסם

#!/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

שותף נתונים

#!/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

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח ב-‎.NET כדי להוסיף תלות לספריית הלקוח בפרויקט.

אופציונלי: התקנת ספריית הכלים

בנוסף לספריית הלקוח, אתם יכולים להתקין את ספריית השירות כדי לבצע משימות נפוצות כמו עיצוב נתונים להטמעה.

בפרויקט ב-‎ .NET, מצהירים על תלות בספריית השירות Google.Ads.DataManager.Util.
```
dotnet add package Google.Ads.DataManager.Util --version 0.4.0
```
כדי לעצב נתונים, משתמשים בכלי UserDataFormatter בפרויקט ב-‎ .NET.

עיון בדוגמאות קוד

אפשר לעיין בדוגמאות הקוד בספריית המשנה samples או ב-GitHub.

כדי להריץ דוגמאות:

משכפלים את המאגר ב-GitHub בתג v0.4.0:

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

עוברים לספרייה data-manager-dotnet.
עוברים לספרייה samples ומשתמשים ב-dotnet run כדי לקבל את רשימת הדוגמאות הזמינות.
```
dotnet run
```
כדי להדפיס הצהרת שימוש עם הפרמטרים הצפויים, מעבירים את הארגומנט --help כשמריצים דוגמה.
```
dotnet run -- ingest-audience-members --help
```

כדי להתחיל לעבוד עם נתונים לדוגמה, אתם יכולים להשתמש בקבצים שבכתובת samples/sampledata.

Go

התקנת ספריית הלקוח

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

מידע נוסף זמין במדריך לספריית הלקוח של Go.

Java

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח ב-Java כדי להוסיף תלות לספריית הלקוח בפרויקט.

אופציונלי: התקנת ספריית הכלים

בנוסף לספריית הלקוח, אתם יכולים להתקין את ספריית כלי העזר כדי לבצע משימות נפוצות כמו עיצוב והצפנה של נתונים להטמעה.

בפרויקט Java, מצהירים על תלות בספריית השירות data-manager-util.

‫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>

כדי להצפין את הנתונים ולשנות את הפורמט שלהם, משתמשים בכלי השירות UserDataFormatter ו-Encrypter בפרויקט Java.

עיון בדוגמאות קוד

אפשר לעיין בדוגמאות הקוד בספריית המשנה data-manager-samples או ב-GitHub.

כדי להריץ דוגמאות:

משכפלים את המאגר ב-GitHub בתג v0.4.0:

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

עוברים לספרייה data-manager-java.
מריצים את הדוגמאות משורת הפקודה באמצעות המשימה run של Gradle, ומעבירים את כל הארגומנטים הנדרשים. כדי להדפיס הצהרת שימוש עם הפרמטרים הצפויים, צריך להעביר את הארגומנט --help כשמריצים דוגמה.

לדוגמה, הפקודה הבאה מריצה את הדוגמה IngestAudienceMembers ומדפיסה הצהרת שימוש:
```
./gradlew data-manager-samples:run \
   --args='IngestAudienceMembers --help'
```

כדי להתחיל לעבוד עם נתונים לדוגמה, אתם יכולים להשתמש בקבצים שבכתובת data-manager-samples/src/main/resources/sampledata.

Node.js

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח של Node.js כדי להוסיף תלות לספריית הלקוח @google-ads/datamanager בפרויקט.

אופציונלי: התקנת ספריית הכלים

בנוסף לספריית הלקוח, אתם יכולים להתקין את ספריית השירות כדי לבצע משימות נפוצות כמו עיצוב נתונים להטמעה.

בפרויקט Node.js, מצהירים על תלות בספריית השירות @google-ads/datamanager-util:
```
npm install @google-ads/datamanager-util
```
כדי לעצב את הנתונים, משתמשים בכלי UserDataFormatter בפרויקט Node.js.

עיון בדוגמאות קוד

אפשר לעיין בדוגמאות הקוד בספריית המשנה samples או ב-GitHub.

כדי להריץ דוגמאות:

משכפלים את המאגר ב-GitHub בתג v0.4.1:

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

עוברים לספרייה data-manager-node.
מתקינים את יחסי התלות כדי להריץ את הדוגמאות:
```
npm install
```
מריצים את הדוגמאות ומעבירים את הארגומנטים הנדרשים. כדי להדפיס הצהרת שימוש עם הפרמטרים הצפויים, מעבירים את הארגומנט --help כשמריצים דוגמה.

לדוגמה, הפקודה הבאה מריצה את הדוגמה ingest-audience-members ומדפיסה הצהרת שימוש:
```
npm run ingest-audience-members -w samples -- --help
```

כדי להתחיל לעבוד עם נתונים לדוגמה, אתם יכולים להשתמש בקבצים שבכתובת samples/sampledata.

PHP

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח של PHP כדי להוסיף תלות לספריית הלקוח googleads/data-manager בפרויקט.

אופציונלי: התקנת ספריית הכלים

בנוסף לספריית הלקוח, אתם יכולים להתקין את ספריית השירות כדי לבצע משימות נפוצות כמו עיצוב נתונים להטמעה.

בקובץ composer.json של פרויקט ה-PHP באותו מארח, מצהירים על תלות בספריית הכלים:
```
composer require googleads/data-manager-util
```
כדי לעצב נתונים, משתמשים בכלי Formatter בפרויקט PHP.

עיון בדוגמאות קוד

אפשר לעיין בדוגמאות הקוד בספריית המשנה samples או ב-GitHub.

כדי להריץ דוגמאות:

משכפלים את המאגר ב-GitHub בתג v0.4.0:

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

עוברים לספרייה data-manager-php/samples.
מתקינים את יחסי התלות כדי להריץ את הדוגמאות:
```
composer install
```
מריצים את הדוגמאות ומעבירים את הארגומנטים הנדרשים. כדי להדפיס הצהרת שימוש עם הפרמטרים הצפויים, מעבירים את הארגומנט --help כשמריצים דוגמה.

לדוגמה, הפקודה הבאה מריצה את הדוגמה ingest_audience_members ומדפיסה הצהרת שימוש:
```
php audiences/ingest_audience_members.php --help
```

כדי להתחיל לעבוד עם נתונים לדוגמה, אתם יכולים להשתמש בקבצים שבכתובת samples/sampledata.

Python

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח של Python כדי להוסיף תלות לספריית הלקוח google-ads-datamanager בפרויקט.

אופציונלי: התקנת ספריית הכלים

בפרויקט Python, מצהירים על תלות בספריית השירות google-ads-datamanager-util.

לדוגמה, אם משתמשים בקובץ requirements.txt בפרויקט, מוסיפים לקובץ את השורה הבאה:
```
google-ads-datamanager-util==0.4.0
```
או להתקין את ספריית הכלים ישירות:
```
pip install google-ads-datamanager-util==0.4.0
```
כדי לעצב ולהצפין את הנתונים, משתמשים בכלי השירות Formatter ו-Encrypter בפרויקט Python.

עיון בדוגמאות קוד

משכפלים את המאגר ב-GitHub בתג v0.4.0:

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

עוברים לספרייה data-manager-python.
מתקינים את יחסי התלות כדי להריץ את הדוגמאות:
```
pip install -r samples/requirements.txt
```
מריצים את הדוגמאות ומעבירים את הארגומנטים הנדרשים. כדי להדפיס הצהרת שימוש עם הפרמטרים הצפויים, מעבירים את הארגומנט --help כשמריצים דוגמה.

לדוגמה, הפקודה הבאה מריצה את הדוגמה ingest_audience_members ומדפיסה הצהרת שימוש:
```
python3 samples/audiences/ingest_audience_members.py --help
```

כדי להתחיל לעבוד עם נתונים לדוגמה, אתם יכולים להשתמש בקבצים שבכתובת samples/sampledata.

Ruby

התקנת ספריית הלקוח

פועלים לפי ההוראות במדריך ההתקנה של ספריית הלקוח של Ruby כדי להוסיף תלות לספריית הלקוח בפרויקט.

השלבים הבאים

הגדרת גישה ל-API

המיומנויות של הסוכן

התקנה של ספריית לקוח קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

דרישות מוקדמות

שלבי ההתקנה

REST

מפרסם

שותף נתונים

‎.NET

התקנת ספריית הלקוח

אופציונלי: התקנת ספריית הכלים

עיון בדוגמאות קוד

Go

התקנת ספריית הלקוח

Java

התקנת ספריית הלקוח

אופציונלי: התקנת ספריית הכלים

עיון בדוגמאות קוד

Node.js

התקנת ספריית הלקוח

אופציונלי: התקנת ספריית הכלים

עיון בדוגמאות קוד

PHP

התקנת ספריית הלקוח

אופציונלי: התקנת ספריית הכלים

עיון בדוגמאות קוד

Python

התקנת ספריית הלקוח

אופציונלי: התקנת ספריית הכלים

עיון בדוגמאות קוד

Ruby

התקנת ספריית הלקוח

השלבים הבאים

התקנה של ספריית לקוח