התחלה מהירה

מדריך ההפעלה המהירה הזה יעזור לכם לבצע את קריאת ה-API הראשונה שלכם אל Google Ads API.

מושגים מרכזיים

  • ‫קוד מפתח: קוד מפתח הוא מחרוזת אלפאנומרית באורך 22 תווים שמזהה את האפליקציה שלכם בשרתים של Google Ads API. המפתח נדרש כדי לבצע קריאות ל-API.
  • רמת הגישה ל-API: רמת הגישה ל-API של טוקן המפתח שלך קובעת את מספר הקריאות ל-API שאתה יכול לבצע ביום ואת הסביבות שבהן אתה יכול לבצע קריאות ל-API.
  • חשבון ניהול ב-Google Ads: חשבון ניהול ב-Google Ads משמש לניהול של חשבונות Google Ads אחרים. אפשר להשתמש בחשבון ניהול ב-Google Ads כדי לנהל חשבונות לקוח ב-Google Ads או חשבונות ניהול אחרים ב-Google Ads. כדי לקבל קוד מפתח, צריך להיות לכם חשבון ניהול ב-Google Ads.
  • חשבון לקוח ב-Google Ads: חשבון Google Ads שמופעלות מולו קריאות ל-API.
  • מספר לקוח של לקוח: מספר בן 10 ספרות שמזהה חשבון לקוח ב-Google Ads.
  • ‫OAuth 2.0:‏ OAuth 2.0 הוא פרוטוקול הרשאה בתקן התעשייה, שמשמש את כל ממשקי ה-API של Google. כדי ליצור פרטי כניסה מסוג OAuth 2.0 ולבצע קריאות ל-API, צריך חשבון שירות ומפתח.
  • פרויקט Google Cloud: פרויקט Google Cloud הוא הבסיס ליצירה, להפעלה ולשימוש של כל שירותי Google, כולל ניהול ממשקי API ופרטי כניסה של OAuth 2.0 API. אפשר ליצור פרויקט חדש במסוף Google Cloud.
  • חשבון שירות: סוג מיוחד של חשבון Google ששייך לאפליקציה ולא למשתמש פרטי. הוא משמש לאימות האפליקציה שלכם ב-Google Ads API. כדי לקבל חשבון שירות, צריך פרויקט ב-Google Cloud.
  • מפתח לחשבון שירות: קובץ JSON של פרטי כניסה לאפליקציה שמכיל את המפתח הפרטי של חשבון השירות. הוא משמש ליצירת פרטי כניסה מסוג OAuth 2.0 כדי לאמת חשבון שירות כשמבצעים קריאה ל-Google Ads API. כדי לקבל מפתח לחשבון שירות, צריך חשבון שירות.

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

כדי לבצע קריאה ל-Google Ads API, צריך לבצע את השלבים הבאים.

קבלת קוד מפתח

אם נרשמתם בעבר לקבלת קוד מפתח, תוכלו למצוא אותו במרכז ה-API כשאתם מחוברים לחשבון הניהול שלכם ב-Google Ads.

גישה אל API Center

אם אין לכם קוד מפתח, אתם יכולים להירשם כדי לקבל קוד כזה במרכז ה-API.

איך נרשמים לקוד מפתח

  1. בדפדפן האינטרנט, עוברים אל API Center. אם תתבקשו, היכנסו לחשבון הניהול ב-Google Ads. אם אין לכם חשבון ניהול, אתם צריכים ליצור חשבון ניהול ב-Google Ads.
  2. ממלאים את טופס הגישה ל-API ומאשרים את התנאים וההגבלות.
    • חשוב לוודא שהפרטים נכונים וכתובת האתר של החברה פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה ולדחות אותה.
    • חשוב לוודא שכתובת האימייל של איש הקשר בנושא API שציינתם מובילה לתיבת דואר נכנס שנבדקת באופן קבוע. יכול להיות שצוות התאימות של Google ל-API יפנה לכתובת האימייל הזו במהלך תהליך הבדיקה כדי לקבל הבהרות. אם לא נוכל ליצור איתך קשר, יכול להיות ש-Google לא תמשיך בתהליך הבקשה.
    • אפשר לערוך את כתובת האימייל של איש הקשר בנושא API במרכז ה-API. חשוב לשמור את הפרטים האלה עדכניים, גם אחרי תהליך הגשת הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.

אחרי שמסיימים את תהליך הבקשה, קוד המפתח מופיע במרכז ה-API עם הסטטוס בהמתנה לאישור. ל-developer token שלך יש עכשיו רמת גישה של Test Account Access.

הגדרת הפרויקט ב-Google API Console

הפרויקט ב-Google API Console משמש לניהול ממשקי Google API ופרטי הכניסה של OAuth 2.0 API. אפשר למצוא את הפרויקטים הקיימים שלכם ב-Google API Console או ליצור פרויקט חדש ב-Google API Console.

פתיחת Google API Console

השלב הראשון הוא להפעיל את Google Ads API בפרויקט:

הפעלת Google Ads API

בשלב הבא, צריך חשבון שירות ומפתח של חשבון שירות כדי לבצע קריאות ל-API. אם אתם כבר משתמשים ב-Google API אחר ויצרתם מפתח וחשבון שירות OAuth 2.0, אתם יכולים לדלג על השלב הזה ולהשתמש שוב בפרטי הכניסה הקיימים.

איך יוצרים חשבון שירות ומפתח

  1. בתפריט של מסוף Google Cloud, לוחצים על > IAM & Admin ‏(IAM ומנהל מערכת) > Service Accounts ‏(חשבונות שירות).

    לדף Service accounts

  2. בוחרים את חשבון השירות.
  3. לוחצים על מפתחות > הוספת מפתח > יצירת מפתח חדש.
  4. בוחרים באפשרות JSON ולוחצים על Create.

    זוג המפתחות הציבורי/הפרטי החדש נוצר ומורד למחשב שלכם כקובץ חדש. שומרים את קובץ ה-JSON שהורדתם בשם credentials.json בספריית העבודה. הקובץ הזה הוא העותק היחיד של המפתח הזה.

  5. לוחצים על סגירה.

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

גישה בסיסית וגישה רגילה

אפשר להתקשר לחשבון הייצור שלכם ב-Google Ads. עם זאת, אם צריך, אפשר ליצור חשבון בדיקה ב-Google Ads לפי ההוראות שבכרטיסייה גישה לחשבון בדיקה.

בדיקת הגישה לחשבון

אי אפשר להשתמש בקוד המפתח כדי לבצע קריאות ל-API בחשבון פעיל ב-Google Ads. אפשר לבצע קריאות ל-API רק בחשבונות בדיקה של Google Ads.

איך יוצרים חשבון בדיקה ב-Google Ads

ההוראות הבאות מתייחסות ליצירה של חשבון ניהול לבדיקה ב-Google Ads ושל חשבון פרסום לבדיקה ב-Google Ads שמשויך אליו.

  1. לוחצים על הלחצן הכחול כדי ליצור חשבון ניהול לבדיקה ב-Google Ads. אם תתבקשו לעשות זאת, היכנסו לחשבון Google שלא מקושר לחשבון הניהול שלכם ב-Google Ads. אם אין לכם חשבון, אתם יכולים ללחוץ על הלחצן יצירת חשבון בדף הזה כדי ליצור חשבון Google חדש.

    יצירת חשבון ניהול לבדיקה ב-Google Ads

  2. בחשבון הניהול לבדיקות ב-Google Ads, יוצרים חשבון לקוח לבדיקות ב-Google Ads: לוחצים על חשבונות > > יצירת חשבון חדש וממלאים את הטופס. כל חשבון Google Ads שתיצרו מחשבון הניהול של חשבון הבדיקה של Google Ads יהיה באופן אוטומטי חשבון בדיקה של Google Ads.
  3. אפשרות נוספת היא ליצור כמה קמפיינים בחשבון הלקוח לבדיקה ב-Google Ads מתוך הדף של Google Ads.

כדי לבצע קריאה ל-API של לקוח Google Ads, צריך לתת לחשבון השירות גישה והרשאות מתאימות לחשבון הלקוח ב-Google Ads. כדי לעשות את זה, צריך הרשאת אדמין בחשבון הלקוח.

איך מעניקים לחשבון השירות גישה לחשבון Google Ads

  1. קודם נכנסים לחשבון Google Ads כאדמין.
  2. עוברים אל Admin > Access and security (ניהול > אבטחה וגישה).
  3. לוחצים על הלחצן בכרטיסייה משתמשים.
  4. מקלידים את כתובת האימייל של חשבון השירות בתיבת הקלט Email (אימייל). בוחרים את רמת הגישה המתאימה לחשבון ולוחצים על הלחצן הוספת חשבון. הערה: רמת הגישה לאימייל לא נתמכת בחשבונות שירות.
  5. ניתנת גישה לחשבון השירות.
  6. [אופציונלי] כברירת מחדל, אי אפשר להעניק גישת אדמין לחשבון שירות. אם הקריאות ל-API דורשות גישת אדמין, אפשר לשדרג את הגישה באופן הבא.
    1. לוחצים על החץ לתפריט נפתח לצד רמת הגישה של חשבון השירות בעמודה רמת גישה.
    2. בוחרים באפשרות אדמין מהתפריט הנפתח.

הורדת כלים וספריות לקוח

אתם יכולים לבחור להוריד ספריית לקוח או לקוח HTTP, בהתאם לאופן שבו אתם רוצים לבצע קריאות ל-API.

שימוש בספריית לקוח

מורידים ומתקינים ספריית לקוח לפי בחירה.

שימוש בלקוח HTTP ‏ (REST)

curl

מורידים ומתקינים את curl, כלי שורת הפקודה להעברת נתונים באמצעות כתובת URL.

‫Google Cloud CLI

פועלים לפי ההוראות כדי להתקין את gcloud CLI.

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

:~$ gcloud version
Google Cloud SDK 492.0.0
alpha 2024.09.06
beta 2024.09.06
bq 2.1.8
bundled-python3-unix 3.11.9
core 2024.09.06
enterprise-certificate-proxy 0.3.2
gcloud-crc32c 1.0.0
gsutil 5.30

ביצוע קריאה ל-API

בוחרים את הלקוח הרצוי כדי לקבל הוראות לגבי ביצוע קריאה ל-API:

Java

הארטיפקטים של ספריית הלקוח מתפרסמים ב-Maven central repository. מוסיפים את ספריית הלקוח כתלות בפרויקט באופן הבא:

התלות ב-Maven היא:

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
  <version>40.0.0</version>
</dependency>

התלות ב-Gradle היא:

implementation 'com.google.api-ads:google-ads:40.0.0'

api.googleads.serviceAccountSecretsPath=JSON_KEY_FILE_PATH
api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
api.googleads.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

יוצרים אובייקט GoogleAdsClient באופן הבא:

GoogleAdsClient googleAdsClient = null;
try {
  googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
} catch (FileNotFoundException fnfe) {
  System.err.printf(
      "Failed to load GoogleAdsClient configuration from file. Exception: %s%n",
      fnfe);
  System.exit(1);
} catch (IOException ioe) {
  System.err.printf("Failed to create GoogleAdsClient. Exception: %s%n", ioe);
  System.exit(1);
}

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

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
  try (GoogleAdsServiceClient googleAdsServiceClient =
      googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
    String query = "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";
    // Constructs the SearchGoogleAdsStreamRequest.
    SearchGoogleAdsStreamRequest request =
        SearchGoogleAdsStreamRequest.newBuilder()
            .setCustomerId(Long.toString(customerId))
            .setQuery(query)
            .build();

    // Creates and issues a search Google Ads stream request that will retrieve all campaigns.
    ServerStream<SearchGoogleAdsStreamResponse> stream =
        googleAdsServiceClient.searchStreamCallable().call(request);

    // Iterates through and prints all of the results in the stream response.
    for (SearchGoogleAdsStreamResponse response : stream) {
      for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
        System.out.printf(
            "Campaign with ID %d and name '%s' was found.%n",
            googleAdsRow.getCampaign().getId(), googleAdsRow.getCampaign().getName());
      }
    }
  }
}
GetCampaigns.java

C#‎

חבילות של ספריות לקוח מתפרסמות במאגר Nuget.org. מתחילים בהוספת הפניה ל-NuGet לחבילה Google.Ads.GoogleAds.

dotnet add package Google.Ads.GoogleAds --version 18.1.0

יוצרים אובייקט GoogleAdsConfig עם ההגדרות הרלוונטיות, ומשתמשים בו כדי ליצור אובייקט GoogleAdsClient.

GoogleAdsConfig config = new GoogleAdsConfig()
{
    DeveloperToken = "******",
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = ******
};
GoogleAdsClient client = new GoogleAdsClient(config);

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

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsService = client.GetService(
        Services.V21.GoogleAdsService);

    // Create a query that will retrieve all campaigns.
    string query = @"SELECT
                    campaign.id,
                    campaign.name,
                    campaign.network_settings.target_content_network
                FROM campaign
                ORDER BY campaign.id";

    try
    {
        // Issue a search request.
        googleAdsService.SearchStream(customerId.ToString(), query,
            delegate (SearchGoogleAdsStreamResponse resp)
            {
                foreach (GoogleAdsRow googleAdsRow in resp.Results)
                {
                    Console.WriteLine("Campaign with ID {0} and name '{1}' was found.",
                        googleAdsRow.Campaign.Id, googleAdsRow.Campaign.Name);
                }
            }
        );
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
GetCampaigns.cs

PHP

חבילות של ספריות לקוח מתפרסמות במאגר Packagist. עוברים לספריית הבסיס של הפרויקט ומריצים את הפקודה הבאה כדי להתקין את הספרייה ואת כל התלויות שלה בספרייה vendor/ של ספריית הבסיס של הפרויקט.

composer require googleads/google-ads-php:31.0.0

יוצרים עותק של הקובץ google_ads_php.ini ממאגר GitHub ומשנים אותו כך שיכלול את פרטי הכניסה שלכם.

[GOOGLE_ADS]
developerToken = "INSERT_DEVELOPER_TOKEN_HERE"
loginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/adwords"

יוצרים מופע של אובייקט GoogleAdsClient.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

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

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    $googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
    // Creates a query that retrieves all campaigns.
    $query = 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id';
    // Issues a search stream request.
    /** @var GoogleAdsServerStreamDecorator $stream */
    $stream = $googleAdsServiceClient->searchStream(
        SearchGoogleAdsStreamRequest::build($customerId, $query)
    );

    // Iterates over all rows in all messages and prints the requested field values for
    // the campaign in each row.
    foreach ($stream->iterateAllElements() as $googleAdsRow) {
        /** @var GoogleAdsRow $googleAdsRow */
        printf(
            "Campaign with ID %d and name '%s' was found.%s",
            $googleAdsRow->getCampaign()->getId(),
            $googleAdsRow->getCampaign()->getName(),
            PHP_EOL
        );
    }
}
GetCampaigns.php

Python

ספריית הלקוח מופצת ב-PyPI ואפשר להתקין אותה באמצעות הפקודה pip באופן הבא:

python -m pip install google-ads==21.3.0

יוצרים עותק של הקובץ google-ads.yaml ממאגר GitHub ומשנים אותו כך שיכלול את פרטי הכניסה שלכם.

developer_token: INSERT_DEVELOPER_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
json_key_file_path: JSON_KEY_FILE_PATH_HERE

יוצרים מכונת GoogleAdsClient על ידי קריאה ל-method‏ GoogleAdsClient.load_from_storage. מעבירים את הנתיב אל google-ads.yaml כמחרוזת לשיטה כשמפעילים אותה:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage("path/to/google-ads.yaml")

מוסיפים ל-logger של הספרייה handler שמציין איפה להדפיס את היומנים. הקוד הבא יורה ל-logger של הספרייה להדפיס במסוף (stdout).

import logging
import sys

logger = logging.getLogger('google.ads.googleads.client')
logger.addHandler(logging.StreamHandler(sys.stdout))

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

def main(client: GoogleAdsClient, customer_id: str) -> None:
    ga_service: GoogleAdsServiceClient = client.get_service("GoogleAdsService")

    query: str = """
        SELECT
          campaign.id,
          campaign.name
        FROM campaign
        ORDER BY campaign.id"""

    # Issues a search request using streaming.
    stream: Iterator[SearchGoogleAdsStreamResponse] = ga_service.search_stream(
        customer_id=customer_id, query=query
    )

    for batch in stream:
        rows: List[GoogleAdsRow] = batch.results
        for row in rows:
            print(
                f"Campaign with ID {row.campaign.id} and name "
                f'"{row.campaign.name}" was found.'
            )
get_campaigns.py

Ruby

קבצי ה-gem של Ruby עבור ספריית הלקוח מתפרסמים באתר האירוח של Rubygems gem. הדרך המומלצת להתקין היא באמצעות bundler. מוסיפים שורה לקובץ Gemfile:

gem 'google-ads-googleads', '~> 35.2.0'

ואז מריצים:

bundle install

יוצרים עותק של הקובץ google_ads_config.rb ממאגר GitHub ומשנים אותו כך שיכלול את פרטי הכניסה שלכם.

Google::Ads::GoogleAds::Config.new do |c|
  c.developer_token = 'INSERT_DEVELOPER_TOKEN_HERE'
  c.login_customer_id = 'INSERT_LOGIN_CUSTOMER_ID_HERE'
  c.keyfile = 'JSON_KEY_FILE_PATH'
end

יוצרים מופע GoogleAdsClient על ידי העברת הנתיב למיקום שבו שומרים את הקובץ הזה.

client = Google::Ads::GoogleAds::GoogleAdsClient.new('path/to/google_ads_config.rb')

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

def get_campaigns(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new

  responses = client.service.google_ads.search_stream(
    customer_id: customer_id,
    query: 'SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id',
  )

  responses.each do |response|
    response.results.each do |row|
      puts "Campaign with ID #{row.campaign.id} and name '#{row.campaign.name}' was found."
    end
  end
end
get_campaigns.rb

Perl

הספרייה מופצת ב-CPAN. מתחילים בשיבוט מאגר google-ads-perl בספרייה הרצויה.

git clone https://github.com/googleads/google-ads-perl.git

עוברים לספרייה google-ads-perl ומריצים את הפקודה הבאה בשורת הפקודה כדי להתקין את כל יחסי התלות שנדרשים לשימוש בספרייה.

cd google-ads-perl
cpan install Module::Build
perl Build.PL
perl Build installdeps

יוצרים עותק של הקובץ googleads.properties ממאגר GitHub ומשנים אותו כך שיכלול את פרטי הכניסה שלכם.

jsonKeyFilePath=JSON_KEY_FILE_PATH
developerToken=INSERT_DEVELOPER_TOKEN_HERE
loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

יוצרים מופע Client על ידי העברת הנתיב למיקום שבו שומרים את הקובץ הזה.

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

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

sub get_campaigns {
  my ($api_client, $customer_id) = @_;

  # Create a search Google Ads stream request that will retrieve all campaigns.
  my $search_stream_request =
    Google::Ads::GoogleAds::V21::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
    ->new({
      customerId => $customer_id,
      query      =>
        "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
    });

  # Get the GoogleAdsService.
  my $google_ads_service = $api_client->GoogleAdsService();

  my $search_stream_handler =
    Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
      service => $google_ads_service,
      request => $search_stream_request
    });

  # Issue a search request and process the stream response to print the requested
  # field values for the campaign in each row.
  $search_stream_handler->process_contents(
    sub {
      my $google_ads_row = shift;
      printf "Campaign with ID %d and name '%s' was found.\n",
        $google_ads_row->{campaign}{id}, $google_ads_row->{campaign}{name};
    });

  return 1;
}
get_campaigns.pl

curl

מתחילים בהגדרת חשבון השירות כפרטי הכניסה הפעילים ב-CLI של gcloud.

gcloud auth login --cred-file=PATH_TO_CREDENTIALS_JSON

לאחר מכן, מאחזרים אסימון גישה מסוג OAuth 2.0 ל-Google Ads API.

gcloud auth \
  print-access-token \
  --scopes='https://www.googleapis.com/auth/adwords'

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

curl -i -X POST https://googleads.googleapis.com/v21/customers/CUSTOMER_ID/googleAds:searchStream \
   -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -H "developer-token: DEVELOPER_TOKEN" \
   -H "login-customer-id: LOGIN_CUSTOMER_ID" \
   --data-binary "@query.json"

התוכן של query.json הוא:

{
  "query": "SELECT campaign.id, campaign.name, campaign.network_settings.target_content_network FROM campaign ORDER BY campaign.id"
}
הקודם
מבוא
הבא
שגיאות נפוצות