Add Call
Stay organized with collections
Save and categorize content based on your preferences.
Java
// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package
com.google.ads.googleads.examples.assets
;
import
com.beust.jcommander.Parameter
;
import
com.google.ads.googleads.examples.utils.ArgumentNames
;
import
com.google.ads.googleads.examples.utils.CodeSampleParams
;
import
com.google.ads.googleads.lib.GoogleAdsClient
;
import
com.google.ads.googleads.v21.common.AdScheduleInfo
;
import
com.google.ads.googleads.v21.common.CallAsset
;
import
com.google.ads.googleads.v21.enums.AssetFieldTypeEnum.AssetFieldType
;
import
com.google.ads.googleads.v21.enums.CallConversionReportingStateEnum.CallConversionReportingState
;
import
com.google.ads.googleads.v21.enums.DayOfWeekEnum.DayOfWeek
;
import
com.google.ads.googleads.v21.enums.MinuteOfHourEnum.MinuteOfHour
;
import
com.google.ads.googleads.v21.errors.GoogleAdsError
;
import
com.google.ads.googleads.v21.errors.GoogleAdsException
;
import
com.google.ads.googleads.v21.resources.Asset
;
import
com.google.ads.googleads.v21.resources.CustomerAsset
;
import
com.google.ads.googleads.v21.services.AssetOperation
;
import
com.google.ads.googleads.v21.services.AssetServiceClient
;
import
com.google.ads.googleads.v21.services.CustomerAssetOperation
;
import
com.google.ads.googleads.v21.services.CustomerAssetServiceClient
;
import
com.google.ads.googleads.v21.services.MutateAssetsResponse
;
import
com.google.ads.googleads.v21.services.MutateCustomerAssetsResponse
;
import
com.google.ads.googleads.v21.utils.ResourceNames
;
import
com.google.common.collect.ImmutableList
;
import
java.io.FileNotFoundException
;
import
java.io.IOException
;
/** This example adds a call asset to a specific account. */
public
class
AddCall
{
private
static
class
AddCallParams
extends
CodeSampleParams
{
@Parameter
(
names
=
ArgumentNames
.
CUSTOMER_ID
,
required
=
true
)
private
Long
customerId
;
// Specifies the phone country code here or the default specified below will be used.
// See supported codes at:
// https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
@Parameter
(
names
=
ArgumentNames
.
PHONE_COUNTRY
,
required
=
true
)
private
String
phoneCountry
=
"US"
;
@Parameter
(
names
=
ArgumentNames
.
PHONE_NUMBER
,
required
=
true
)
private
String
phoneNumber
;
// Optional: Specifies the conversion action ID to attribute call conversions to. If not set,
// the default conversion action is used.
@Parameter
(
names
=
ArgumentNames
.
CONVERSION_ACTION_ID
)
private
Integer
conversionActionId
;
}
public
static
void
main
(
String
[]
args
)
throws
IOException
{
AddCallParams
params
=
new
AddCallParams
();
if
(
!
params
.
parseArguments
(
args
))
{
// Either pass the required parameters for this example on the command line, or insert them
// into the code here. See the parameter class definition above for descriptions.
params
.
customerId
=
Long
.
parseLong
(
"INSERT_CUSTOMER_ID_HERE"
);
params
.
phoneCountry
=
"US"
;
params
.
phoneNumber
=
"INSERT_PHONE_NUMBER_HERE"
;
// Optional: Specifies the conversion action ID to attribute call conversions to. If not set,
// the default conversion action is used.
params
.
conversionActionId
=
null
;
}
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
);
}
try
{
new
AddCall
()
.
runExample
(
googleAdsClient
,
params
.
customerId
,
params
.
phoneCountry
,
params
.
phoneNumber
,
params
.
conversionActionId
);
}
catch
(
GoogleAdsException
gae
)
{
// GoogleAdsException is the base class for most exceptions thrown by an API request.
// Instances of this exception have a message and a GoogleAdsFailure that contains a
// collection of GoogleAdsErrors that indicate the underlying causes of the
// GoogleAdsException.
System
.
err
.
printf
(
"Request ID %s failed due to GoogleAdsException. Underlying errors:%n"
,
gae
.
getRequestId
());
int
i
=
0
;
for
(
GoogleAdsError
googleAdsError
:
gae
.
getGoogleAdsFailure
().
getErrorsList
())
{
System
.
err
.
printf
(
" Error %d: %s%n"
,
i
++
,
googleAdsError
);
}
System
.
exit
(
1
);
}
}
/**
* Runs the example.
*
* @param googleAdsClient the Google Ads API client.
* @param customerId the client customer ID.
* @param phoneCountry the phone country (2-letter code).
* @param phoneNumber the raw phone number, e.g. '(800) 555-0100'.
* @param conversionActionId the conversion action ID to attribute conversions to.
* @throws GoogleAdsException if an API request failed with one or more service errors.
*/
private
void
runExample
(
GoogleAdsClient
googleAdsClient
,
long
customerId
,
String
phoneCountry
,
String
phoneNumber
,
Integer
conversionActionId
)
{
// Creates the call asset.
String
assetResourceName
=
addCallAsset
(
googleAdsClient
,
customerId
,
phoneCountry
,
phoneNumber
,
conversionActionId
);
// Links the assets at the account level, so they will serve in all eligible campaigns.
linkAssetToAccount
(
googleAdsClient
,
customerId
,
assetResourceName
);
}
/**
* Creates a new call asset.
*
* @param googleAdsClient the Google Ads API client.
* @param customerId the client customer ID.
* @param phoneCountry the phone country (2-letter code).
* @param phoneNumber the raw phone number, e.g. '(800) 555-0100'.
* @param conversionActionId the conversion action ID to attribute conversions to.
* @return resource name of the newly created asset.
*/
private
String
addCallAsset
(
GoogleAdsClient
googleAdsClient
,
long
customerId
,
String
phoneCountry
,
String
phoneNumber
,
Integer
conversionActionId
)
{
CallAsset
.
Builder
callAssetBuilder
=
CallAsset
.
newBuilder
()
// Sets the country code and phone number of the business to call.
.
setCountryCode
(
phoneCountry
)
.
setPhoneNumber
(
phoneNumber
)
// Optional: Specifies all day and time intervals for which the asset may serve.
.
addAdScheduleTargets
(
AdScheduleInfo
.
newBuilder
()
// Sets the day of this schedule as Monday.
.
setDayOfWeek
(
DayOfWeek
.
MONDAY
)
// Sets the start hour to 9am.
.
setStartHour
(
9
)
// Sets the end hour to 5pm.
.
setEndHour
(
17
)
// Sets the start and end minute of zero, for example: 9:00 and 5:00.
.
setStartMinute
(
MinuteOfHour
.
ZERO
)
.
setEndMinute
(
MinuteOfHour
.
ZERO
)
.
build
());
// Sets the conversion action ID to the one provided if any.
if
(
conversionActionId
!=
null
)
{
callAssetBuilder
.
setCallConversionAction
(
ResourceNames
.
conversionAction
(
customerId
,
conversionActionId
))
.
setCallConversionReportingState
(
CallConversionReportingState
.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
);
}
// Creates an asset operation wrapping the call asset in an asset.
AssetOperation
assetOperation
=
AssetOperation
.
newBuilder
()
.
setCreate
(
Asset
.
newBuilder
().
setCallAsset
(
callAssetBuilder
.
build
()).
build
())
.
build
();
// Creates an asset service client.
try
(
AssetServiceClient
assetServiceClient
=
googleAdsClient
.
getLatestVersion
().
createAssetServiceClient
())
{
// Issues a mutate request to add the asset and prints its information.
MutateAssetsResponse
response
=
assetServiceClient
.
mutateAssets
(
Long
.
toString
(
customerId
),
ImmutableList
.
of
(
assetOperation
));
String
createdAssetResourceName
=
response
.
getResults
(
0
).
getResourceName
();
System
.
out
.
printf
(
"Created a call asset with resource name: '%s'.%n"
,
createdAssetResourceName
);
return
createdAssetResourceName
;
}
}
/**
* Links the call asset at the account level to serve in all eligible campaigns.
*
* @param googleAdsClient the Google Ads API client.
* @param customerId the client customer ID.
* @param assetResourceName the resource name of the call asset.
*/
private
void
linkAssetToAccount
(
GoogleAdsClient
googleAdsClient
,
long
customerId
,
String
assetResourceName
)
{
// Creates a customer asset operation wrapping the call asset in a customer asset.
CustomerAssetOperation
customerAssetOperation
=
CustomerAssetOperation
.
newBuilder
()
.
setCreate
(
CustomerAsset
.
newBuilder
()
.
setAsset
(
assetResourceName
)
.
setFieldType
(
AssetFieldType
.
CALL
)
.
build
())
.
build
();
// Creates a CustomerAssetServiceClient.
try
(
CustomerAssetServiceClient
customerAssetServiceClient
=
googleAdsClient
.
getLatestVersion
().
createCustomerAssetServiceClient
())
{
// Issues a mutate request to add the customer asset and prints its information.
MutateCustomerAssetsResponse
response
=
customerAssetServiceClient
.
mutateCustomerAssets
(
Long
.
toString
(
customerId
),
ImmutableList
.
of
(
customerAssetOperation
));
System
.
out
.
printf
(
"Created a customer asset with resource name: '%s'.%n"
,
response
.
getResults
(
0
).
getResourceName
());
}
}
}
C#
// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
using
CommandLine
;
using
Google.Ads.Gax.Examples
;
using
Google.Ads.GoogleAds.Lib
;
using
Google.Ads.GoogleAds.V21.Common
;
using
Google.Ads.GoogleAds.V21.Errors
;
using
Google.Ads.GoogleAds.V21.Resources
;
using
Google.Ads.GoogleAds.V21.Services
;
using
System.Linq
;
using
System
;
using
static
Google
.
Ads
.
GoogleAds
.
V21
.
Enums
.
AssetFieldTypeEnum
.
Types
;
using
static
Google
.
Ads
.
GoogleAds
.
V21
.
Enums
.
CallConversionReportingStateEnum
.
Types
;
using
static
Google
.
Ads
.
GoogleAds
.
V21
.
Enums
.
MinuteOfHourEnum
.
Types
;
using
SystemDayOfWeek
=
System
.
DayOfWeek
;
using
DayOfWeek
=
Google
.
Ads
.
GoogleAds
.
V21
.
Enums
.
DayOfWeekEnum
.
Types
.
DayOfWeek
;
namespace
Google.Ads.GoogleAds.Examples.V21
{
/// <summary>
/// This example adds a call asset to a specific account.
/// </summary>
public
class
AddCall
:
ExampleBase
{
/// <summary>
/// Command line options for running the <see cref="AddCall"/> example.
/// </summary>
public
class
Options
:
OptionsBase
{
/// <summary>
/// The Google Ads customer ID.
/// </summary>
[Option("customerId", Required = true, HelpText =
"The Google Ads customer ID.")]
public
long
CustomerId
{
get
;
set
;
}
/// <summary>
/// Optional: The phone number country.
///
/// Specifies the phone country code here or the default specified in <see cref="Main"/>
/// will be used. See supported codes at:
/// https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
/// </summary>
[Option("phoneCountry", Required = false, HelpText =
"The phone number country.")]
public
string
PhoneCountry
{
get
;
set
;
}
/// <summary>
/// The phone number itself.
/// </summary>
[Option("phoneNumber", Required = true, HelpText =
"The phone number itself.")]
public
string
PhoneNumber
{
get
;
set
;
}
/// <summary>
/// Optional: Specifies the conversion action ID to attribute call conversions to. If not set,
/// the default conversion action is used.
/// </summary>
[Option("conversionActionId", Required = false, HelpText =
"The conversion action ID.")]
public
long?
ConversionActionId
{
get
;
set
;
}
}
/// <summary>
/// Main method, to run this code example as a standalone application.
/// </summary>
/// <param name="args">The command line arguments.</param>
public
static
void
Main
(
string
[]
args
)
{
Options
options
=
ExampleUtilities
.
ParseCommandLine<Options>
(
args
);
AddCall
codeExample
=
new
AddCall
();
Console
.
WriteLine
(
codeExample
.
Description
);
codeExample
.
Run
(
new
GoogleAdsClient
(),
options
.
CustomerId
,
options
.
PhoneCountry
,
options
.
PhoneNumber
,
options
.
ConversionActionId
);
}
/// <summary>
/// Returns a description about the code example.
/// </summary>
public
override
string
Description
=
>
"This example adds a call ad to a given ad group."
;
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="phoneCountry">The phone number country.</param>
/// <param name="phoneNumber">The phone number itself.</param>
/// <param name="conversionActionId">The conversion action ID or null.</param>
public
void
Run
(
GoogleAdsClient
client
,
long
customerId
,
string
phoneCountry
,
string
phoneNumber
,
long?
conversionActionId
)
{
try
{
// Creates the call asset for the call.
string
assetResourceName
=
AddCallAsset
(
client
,
customerId
,
phoneCountry
,
phoneNumber
,
conversionActionId
);
// Adds the asset at the account level, so these will serve in all eligible
// campaigns.
LinkAssetToAccount
(
client
,
customerId
,
assetResourceName
);
}
catch
(
GoogleAdsException
e
)
{
Console
.
WriteLine
(
"Failure:"
);
Console
.
WriteLine
(
$"Message: {e.Message}"
);
Console
.
WriteLine
(
$"Failure: {e.Failure}"
);
Console
.
WriteLine
(
$"Request ID: {e.RequestId}"
);
throw
;
}
}
/// <summary>
/// Creates a new asset for the call.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="phoneCountry">The phone number country.</param>
/// <param name="phoneNumber">The phone number itself.</param>
/// <param name="conversionActionId">The conversion action ID or null.</param>
/// <returns>The resource name of the created call asset</returns>
private
string
AddCallAsset
(
GoogleAdsClient
client
,
long
customerId
,
string
phoneCountry
,
string
phoneNumber
,
long?
conversionActionId
)
{
// Creates the call asset.
CallAsset
callAsset
=
new
CallAsset
()
{
// Sets the country code and phone number of the business to call.
CountryCode
=
phoneCountry
,
PhoneNumber
=
phoneNumber
,
// Optional: Specifies all day and time intervals for which the asset may serve.
AdScheduleTargets
=
{
new
AdScheduleInfo
()
{
// Sets the day of this schedule as Monday.
DayOfWeek
=
DayOfWeek
.
Monday
,
// Sets the start hour to 9am.
StartHour
=
9
,
// Sets the end hour to 5pm.
EndHour
=
17
,
// Sets the start and end minute of zero, for example: 9:00 and 5:00.
StartMinute
=
MinuteOfHour
.
Zero
,
EndMinute
=
MinuteOfHour
.
Zero
}
}
};
// Sets the conversion action ID to the one provided if any.
if
(
conversionActionId
.
HasValue
)
{
callAsset
.
CallConversionAction
=
ResourceNames
.
ConversionAction
(
customerId
,
conversionActionId
.
Value
);
callAsset
.
CallConversionReportingState
=
CallConversionReportingState
.
UseResourceLevelCallConversionAction
;
}
// Creates an asset operation wrapping the call asset in an asset.
AssetOperation
assetOperation
=
new
AssetOperation
()
{
Create
=
new
Asset
()
{
CallAsset
=
callAsset
}
};
AssetServiceClient
assetServiceClient
=
client
.
GetService
(
Services
.
V21
.
AssetService
);
// Issues a mutate request to add the asset and prints its information.
MutateAssetsResponse
response
=
assetServiceClient
.
MutateAssets
(
customerId
.
ToString
(),
new
[]
{
assetOperation
}
);
string
createdAssetResourceName
=
response
.
Results
.
First
().
ResourceName
;
Console
.
WriteLine
(
$"Created a call asset with resource name: '{createdAssetResourceName}'."
);
return
createdAssetResourceName
;
}
/// <summary>
/// Links the call asset at the account level to serve in all eligible campaigns.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <param name="assetResourceName">The resource name of the call asset.</param>
private
void
LinkAssetToAccount
(
GoogleAdsClient
client
,
long
customerId
,
string
assetResourceName
)
{
// Creates a customer asset operation wrapping the call asset in a customer asset.
CustomerAssetOperation
customerAssetOperation
=
new
CustomerAssetOperation
()
{
Create
=
new
CustomerAsset
()
{
Asset
=
assetResourceName
,
FieldType
=
AssetFieldType
.
Call
}
};
CustomerAssetServiceClient
customerAssetServiceClient
=
client
.
GetService
(
Services
.
V21
.
CustomerAssetService
);
// Issues a mutate request to add the customer asset and prints its information.
MutateCustomerAssetsResponse
response
=
customerAssetServiceClient
.
MutateCustomerAssets
(
customerId
.
ToString
(),
new
[]
{
customerAssetOperation
}
);
string
resourceName
=
response
.
Results
.
First
().
ResourceName
;
Console
.
WriteLine
(
$"Created a customer asset with resource name: '{resourceName}'."
);
}
}
}
PHP
< ?php
/**
* Copyright 2022 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
namespace Google\Ads\GoogleAds\Examples\Extensions;
require __DIR__ . '/../../vendor/autoload.php';
use GetOpt\GetOpt;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentNames;
use Google\Ads\GoogleAds\Examples\Utils\ArgumentParser;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V21\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V21\GoogleAdsException;
use Google\Ads\GoogleAds\Util\V21\ResourceNames;
use Google\Ads\GoogleAds\V21\Common\AdScheduleInfo;
use Google\Ads\GoogleAds\V21\Common\CallAsset;
use Google\Ads\GoogleAds\V21\Enums\AssetFieldTypeEnum\AssetFieldType;
use Google\Ads\GoogleAds\V21\Enums\CallConversionReportingStateEnum\CallConversionReportingState;
use Google\Ads\GoogleAds\V21\Enums\DayOfWeekEnum\DayOfWeek;
use Google\Ads\GoogleAds\V21\Enums\MinuteOfHourEnum\MinuteOfHour;
use Google\Ads\GoogleAds\V21\Errors\GoogleAdsError;
use Google\Ads\GoogleAds\V21\Resources\Asset;
use Google\Ads\GoogleAds\V21\Resources\CustomerAsset;
use Google\Ads\GoogleAds\V21\Services\AssetOperation;
use Google\Ads\GoogleAds\V21\Services\CustomerAssetOperation;
use Google\Ads\GoogleAds\V21\Services\MutateAssetsRequest;
use Google\Ads\GoogleAds\V21\Services\MutateCustomerAssetsRequest;
use Google\ApiCore\ApiException;
/**
* This example adds a call asset to a specific account.
*/
class AddCall
{
private const CUSTOMER_ID = 'INSERT_CUSTOMER_ID_HERE';
// Specifies the phone country code here or the default specified below will be used.
// See supported codes at:
// https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
private const PHONE_COUNTRY = 'US';
private const PHONE_NUMBER = 'INSERT_PHONE_NUMBER_HERE';
// Optional: Specifies the conversion action ID to attribute call conversions to. If not set,
// the default conversion action is used.
private const CONVERSION_ACTION_ID = null;
public static function main()
{
// Either pass the required parameters for this example on the command line, or insert them
// into the constants above.
$options = (new ArgumentParser())->parseCommandArguments([
ArgumentNames::CUSTOMER_ID => GetOpt::REQUIRED_ARGUMENT,
ArgumentNames::PHONE_COUNTRY => GetOpt::OPTIONAL_ARGUMENT,
ArgumentNames::PHONE_NUMBER => GetOpt::REQUIRED_ARGUMENT,
ArgumentNames::CONVERSION_ACTION_ID => GetOpt::OPTIONAL_ARGUMENT
]);
// Generate a refreshable OAuth2 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())->fromFile()->build();
// Construct a Google Ads client configured from a properties file and the
// OAuth2 credentials above.
$googleAdsClient = (new GoogleAdsClientBuilder())->fromFile()
->withOAuth2Credential($oAuth2Credential)
->build();
try {
self::runExample(
$googleAdsClient,
$options[ArgumentNames::CUSTOMER_ID] ?: self::CUSTOMER_ID,
$options[ArgumentNames::PHONE_COUNTRY] ?: self::PHONE_COUNTRY,
$options[ArgumentNames::PHONE_NUMBER] ?: self::PHONE_NUMBER,
$options[ArgumentNames::CONVERSION_ACTION_ID] ?: self::CONVERSION_ACTION_ID
);
} catch (GoogleAdsException $googleAdsException) {
printf(
"Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
$googleAdsException->getRequestId(),
PHP_EOL,
PHP_EOL
);
foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) {
/** @var GoogleAdsError $error */
printf(
"\t%s: %s%s",
$error->getErrorCode()->getErrorCode(),
$error->getMessage(),
PHP_EOL
);
}
exit(1);
} catch (ApiException $apiException) {
printf(
"ApiException was thrown with message '%s'.%s",
$apiException->getMessage(),
PHP_EOL
);
exit(1);
}
}
/**
* Runs the example.
*
* @param GoogleAdsClient $googleAdsClient the Google Ads API client
* @param int $customerId the client customer ID
* @param string $phoneCountry the phone country (2-letter code)
* @param string $phoneNumber the raw phone number, e.g. '(800) 555-0100'
* @param int|null $conversionActionId the conversion action ID to attribute conversions to
*/
public static function runExample(
GoogleAdsClient $googleAdsClient,
int $customerId,
string $phoneCountry,
string $phoneNumber,
?int $conversionActionId
) {
// Creates the asset for the call assets.
$assetResourceName = self::addCallAsset(
$googleAdsClient,
$customerId,
$phoneCountry,
$phoneNumber,
$conversionActionId
);
// Adds the assets at the account level, so these will serve in all eligible campaigns.
self::linkAssetToAccount($googleAdsClient, $customerId, $assetResourceName);
}
/**
* Creates a new asset for the call.
*
* @param GoogleAdsClient $googleAdsClient the Google Ads API client
* @param int $customerId the client customer ID
* @param string $phoneCountry the phone country (2-letter code)
* @param string $phoneNumber the raw phone number, e.g. '(800) 555-0100'
* @param int|null $conversionActionId the conversion action ID to attribute conversions to
* @return string the resource name of the created call asset
*/
private static function addCallAsset(
GoogleAdsClient $googleAdsClient,
int $customerId,
string $phoneCountry,
string $phoneNumber,
?int $conversionActionId
): string {
// Creates the call asset.
$callAsset = new CallAsset([
// Sets the country code and phone number of the business to call.
'country_code' => $phoneCountry,
'phone_number' => $phoneNumber,
// Optional: Specifies all day and time intervals for which the asset may serve.
'ad_schedule_targets' => [new AdScheduleInfo([
// Sets the day of this schedule as Monday.
'day_of_week' => DayOfWeek::MONDAY,
// Sets the start hour to 9am.
'start_hour' => 9,
// Sets the end hour to 5pm.
'end_hour' => 17,
// Sets the start and end minute of zero, for example: 9:00 and 5:00.
'start_minute' => MinuteOfHour::ZERO,
'end_minute' => MinuteOfHour::ZERO
])]
]);
// Sets the conversion action ID to the one provided if any.
if (!is_null($conversionActionId)) {
$callAsset->setCallConversionAction(
ResourceNames::forConversionAction($customerId, $conversionActionId)
);
$callAsset->setCallConversionReportingState(
CallConversionReportingState::USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
);
}
// Creates an asset operation wrapping the call asset in an asset.
$assetOperation = new AssetOperation();
$assetOperation->setCreate(new Asset(['call_asset' => $callAsset]));
// Issues a mutate request to add the asset and prints its information.
$assetServiceClient = $googleAdsClient->getAssetServiceClient();
$response = $assetServiceClient->mutateAssets(
MutateAssetsRequest::build($customerId, [$assetOperation])
);
$createdAssetResourceName = $response->getResults()[0]->getResourceName();
printf(
"Created a call asset with resource name: '%s'.%s",
$createdAssetResourceName,
PHP_EOL
);
return $createdAssetResourceName;
}
/**
* Links the call asset at the account level to serve in all eligible campaigns.
*
* @param GoogleAdsClient $googleAdsClient the Google Ads API client
* @param int $customerId the client customer ID
* @param string $assetResourceName the resource name of the call asset
*/
private static function linkAssetToAccount(
GoogleAdsClient $googleAdsClient,
int $customerId,
string $assetResourceName
): void {
// Creates a customer asset operation wrapping the call asset in a customer asset.
$customerAssetOperation = new CustomerAssetOperation();
$customerAssetOperation->setCreate(new CustomerAsset([
'asset' => $assetResourceName,
'field_type' => AssetFieldType::CALL
]));
// Issues a mutate request to add the customer asset and prints its information.
$customerAssetServiceClient = $googleAdsClient->getCustomerAssetServiceClient();
$response = $customerAssetServiceClient->mutateCustomerAssets(
MutateCustomerAssetsRequest::build($customerId, [$customerAssetOperation])
);
printf(
"Created a customer asset with resource name: '%s'.%s",
$response->getResults()[0]->getResourceName(),
PHP_EOL
);
}
}
AddCall::main();
Python
#!/usr/bin/env python
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""This example adds a call asset to a specific account."""
import
argparse
from
typing
import
Optional
import
sys
from
google.ads.googleads.client
import
GoogleAdsClient
from
google.ads.googleads.errors
import
GoogleAdsException
from
google.ads.googleads.v21.services.types.asset_service
import
AssetOperation
from
google.ads.googleads.v21.resources.types.asset
import
Asset
from
google.ads.googleads.v21.common.types.criteria
import
AdScheduleInfo
from
google.ads.googleads.v21.services.types.customer_asset_service
import
(
CustomerAssetOperation
,
)
from
google.ads.googleads.v21.resources.types.customer_asset
import
(
CustomerAsset
,
)
# Country code is a two-letter ISO-3166 code, for a list of all codes see:
# https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
_DEFAULT_PHONE_COUNTRY
:
str
=
"US"
def
main
(
client
:
GoogleAdsClient
,
customer_id
:
str
,
phone_number
:
str
,
phone_country
:
str
,
conversion_action_id
:
Optional
[
str
],
)
-
> None
:
"""The main method that creates all necessary entities for the example.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
phone_number: a phone number for your business, e.g. '(800) 555-0100'.
phone_country: a two-letter ISO-3166 code.
conversion_action_id: an ID for a conversion action.
"""
asset_resource_name
:
str
=
add_call_asset
(
client
,
customer_id
,
phone_number
,
phone_country
,
conversion_action_id
)
link_asset_to_account
(
client
,
customer_id
,
asset_resource_name
)
def
add_call_asset
(
client
:
GoogleAdsClient
,
customer_id
:
str
,
phone_number
:
str
,
phone_country
:
str
,
conversion_action_id
:
Optional
[
str
],
)
-
> str
:
"""Creates a new asset for the call.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
phone_number: a phone number for your business, e.g. '(800) 555-0100'.
phone_country: a two-letter ISO-3166 code.
conversion_action_id: an ID for a conversion action.
Returns:
a resource name for a new call asset.
"""
operation
:
AssetOperation
=
client
.
get_type
(
"AssetOperation"
)
# Creates the call asset.
asset
:
Asset
=
operation
.
create
.
call_asset
asset
.
country_code
=
phone_country
asset
.
phone_number
=
phone_number
# Optional: Specifies day and time intervals for which the asset may serve.
ad_schedule
:
AdScheduleInfo
=
client
.
get_type
(
"AdScheduleInfo"
)
# Sets the day of this schedule as Monday.
ad_schedule
.
day_of_week
=
client
.
enums
.
DayOfWeekEnum
.
MONDAY
# Sets the start hour to 9am.
ad_schedule
.
start_hour
=
9
# Sets the end hour to 5pm.
ad_schedule
.
end_hour
=
17
# Sets the start and end minute of zero, for example: 9:00 and 5:00.
ad_schedule
.
start_minute
=
client
.
enums
.
MinuteOfHourEnum
.
ZERO
ad_schedule
.
end_minute
=
client
.
enums
.
MinuteOfHourEnum
.
ZERO
# Appends the ad schedule to the list of ad schedule targets on the asset.
asset
.
ad_schedule_targets
.
append
(
ad_schedule
)
# Sets the conversion action ID if provided.
if
conversion_action_id
:
googleads_service
=
client
.
get_service
(
"GoogleAdsService"
)
asset
.
call_conversion_action
=
googleads_service
.
conversion_action_path
(
customer_id
,
conversion_action_id
)
asset
.
call_conversion_reporting_state
=
(
client
.
enums
.
CallConversionReportingStateEnum
.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
)
# Issues a mutate request to add the asset.
asset_service
=
client
.
get_service
(
"AssetService"
)
response
=
asset_service
.
mutate_assets
(
customer_id
=
customer_id
,
operations
=
[
operation
]
)
resource_name
:
str
=
response
.
results
[
0
]
.
resource_name
print
(
f
"Created a call asset with resource name: '
{
resource_name
}
'"
)
return
resource_name
def
link_asset_to_account
(
client
:
GoogleAdsClient
,
customer_id
:
str
,
asset_resource_name
:
str
)
-
> None
:
"""Links the call asset at the account level to serve in eligible campaigns.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
asset_resource_name: a resource name for the call asset.
"""
operation
:
CustomerAssetOperation
=
client
.
get_type
(
"CustomerAssetOperation"
)
customer_asset
:
CustomerAsset
=
operation
.
create
customer_asset
.
asset
=
asset_resource_name
customer_asset
.
field_type
=
client
.
enums
.
AssetFieldTypeEnum
.
CALL
customer_asset_service
=
client
.
get_service
(
"CustomerAssetService"
)
response
=
customer_asset_service
.
mutate_customer_assets
(
customer_id
=
customer_id
,
operations
=
[
operation
]
)
resource_name
:
str
=
response
.
results
[
0
]
.
resource_name
print
(
f
"Created a customer asset with resource name: '
{
resource_name
}
'"
)
if
__name__
==
"__main__"
:
parser
:
argparse
.
ArgumentParser
=
argparse
.
ArgumentParser
(
description
=
(
"Adds a call asset to a specific account."
)
)
# The following argument(s) should be provided to run the example.
parser
.
add_argument
(
"-c"
,
"--customer_id"
,
type
=
str
,
required
=
True
,
help
=
"The Google Ads customer ID."
,
)
parser
.
add_argument
(
"-n"
,
"--phone_number"
,
type
=
str
,
required
=
True
,
help
=
(
"A phone number for your business, e.g. '(800) 555-0100'"
),
)
parser
.
add_argument
(
"-p"
,
"--phone_country"
,
type
=
str
,
default
=
_DEFAULT_PHONE_COUNTRY
,
help
=
(
"A two-letter ISO-3166 code representing a country code, for a "
"list of all codes see: "
"https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17"
),
)
parser
.
add_argument
(
"-v"
,
"--conversion_action_id"
,
type
=
str
,
help
=
(
"An optional conversion action ID to attribute conversions to."
),
)
args
:
argparse
.
Namespace
=
parser
.
parse_args
()
# GoogleAdsClient will read the google-ads.yaml configuration file in the
# home directory if none is specified.
googleads_client
:
GoogleAdsClient
=
GoogleAdsClient
.
load_from_storage
(
version
=
"v21"
)
try
:
main
(
googleads_client
,
args
.
customer_id
,
args
.
phone_number
,
args
.
phone_country
,
args
.
conversion_action_id
,
)
except
GoogleAdsException
as
ex
:
print
(
f
'Request with ID "
{
ex
.
request_id
}
" failed with status '
f
'"
{
ex
.
error
.
code
()
.
name
}
" and includes the following errors:'
)
for
error
in
ex
.
failure
.
errors
:
print
(
f
'Error with message "
{
error
.
message
}
".'
)
if
error
.
location
:
for
field_path_element
in
error
.
location
.
field_path_elements
:
print
(
f
"
\t\t
On field:
{
field_path_element
.
field_name
}
"
)
sys
.
exit
(
1
)
Ruby
#!/usr/bin/env ruby
# Encoding: utf-8
#
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# This example adds a call asset to a specific account.
require
'date'
require
'google/ads/google_ads'
require
'optparse'
def
add_call
(
customer_id
,
phone_number
,
phone_country
,
conversion_action_id
)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client
=
Google
::
Ads
::
GoogleAds
::
GoogleAdsClient
.
new
asset_resource_name
=
add_call_asset
(
client
,
customer_id
,
phone_number
,
phone_country
,
conversion_action_id
)
link_asset_to_account
(
client
,
customer_id
,
asset_resource_name
)
end
def
add_call_asset
(
client
,
customer_id
,
phone_number
,
phone_country
,
conversion_action_id
)
# Creates the call asset.
operation
=
client
.
operation
.
create_resource
.
asset
do
|
asset
|
asset
.
type
=
:CALL
asset
.
call_asset
=
client
.
resource
.
call_asset
do
|
ca
|
ca
.
country_code
=
phone_country
ca
.
phone_number
=
phone_number
# Optional: Specifies day and time intervals for which the asset may serve.
ad_schedule
=
client
.
resource
.
ad_schedule_info
do
|
as
|
# Sets the day of this schedule as Monday.
as
.
day_of_week
=
:MONDAY
# Sets the start hour to 9am.
as
.
start_hour
=
9
# Sets the end hour to 5pm.
as
.
end_hour
=
17
# Sets the start and end minute of zero, for example: 9:00 and 5:00.
as
.
start_minute
=
:ZERO
as
.
end_minute
=
:ZERO
end
# Appends the ad schedule to the list of ad schedule targets on the asset.
ca
.
ad_schedule_targets
<<
ad_schedule
# Sets the conversion action ID if provided.
if
conversion_action_id
ca
.
call_conversion_action
=
client
.
path
.
conversion_action
(
customer_id
,
conversion_action_id
)
ca
.
call_conversion_reporting_state
=
:USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
end
end
end
# Issues a mutate request to add the asset.
response
=
client
.
service
.
asset
.
mutate_assets
(
customer_id
:
customer_id
,
operations
:
[
operation
]
,
)
resource_name
=
response
.
results
.
first
.
resource_name
puts
"Created a call asset with resource name: '
#{
resource_name
}
'"
resource_name
end
def
link_asset_to_account
(
client
,
customer_id
,
asset_resource_name
)
operation
=
client
.
operation
.
create_resource
.
customer_asset
do
|
ca
|
ca
.
asset
=
asset_resource_name
ca
.
field_type
=
:CALL
end
response
=
client
.
service
.
customer_asset
.
mutate_customer_assets
(
customer_id
:
customer_id
,
operations
:
[
operation
]
,
)
resource_name
=
response
.
results
.
first
.
resource_name
puts
"Created a customer asset with resource name: '
#{
resource_name
}
'"
end
if
__FILE__
==
$0
options
=
{}
# The following parameter(s) should be provided to run the example. You can
# either specify these by changing the INSERT_XXX_ID_HERE values below, or on
# the command line.
#
# Parameters passed on the command line will override any parameters set in
# code.
#
# Running the example with -h will print the command line usage.
options
[
:customer_id
]
=
'INSERT_CUSTOMER_ID_HERE'
options
[
:phone_number
]
=
'INSERT_PHONE_NUMBER_HERE'
OptionParser
.
new
do
|
opts
|
opts
.
banner
=
sprintf
(
'Usage: %s [options]'
,
File
.
basename
(
__FILE__
))
opts
.
separator
''
opts
.
separator
'Options:'
opts
.
on
(
'-C'
,
'--customer-id CUSTOMER-ID'
,
String
,
'The Google Ads customer ID.'
)
do
|
v
|
options
[
:customer_id
]
=
v
end
opts
.
on
(
'-N'
,
'--phone-number PHONE-NUMBER'
,
String
,
"A phone number for your business, e.g. '(800) 555-0100'"
)
do
|
v
|
options
[
:phone_number
]
=
v
end
opts
.
on
(
'-P'
,
'--phone-country PHONE-COUNTRY'
,
String
,
'A two-letter ISO-3166 code representing a country code, for a '
\
'list of all codes see: '
\
'https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17'
)
do
|
v
|
options
[
:phone_country
]
=
v
end
opts
.
on
(
'-V'
,
'--conversion-action-id CONVERSION-ACTION-ID'
,
String
,
'Specifies the conversion action ID to attribute call conversions to. '
\
'If not set, the default conversion action is used.'
)
do
|
v
|
options
[
:conversion_action_id
]
=
v
end
opts
.
separator
''
opts
.
separator
'Help:'
opts
.
on_tail
(
'-h'
,
'--help'
,
'Show this message'
)
do
puts
opts
exit
end
end
.
parse!
begin
add_call
(
options
.
fetch
(
:customer_id
)
.
tr
(
"-"
,
""
),
options
[
:phone_number
]
,
options
.
fetch
(
:phone_country
,
'US'
),
options
[
:conversion_action_id
]
,
)
rescue
Google
::
Ads
::
GoogleAds
::
Errors
::
GoogleAdsError
=
>
e
e
.
failure
.
errors
.
each
do
|
error
|
STDERR
.
printf
(
"Error with message: %s
\n
"
,
error
.
message
)
if
error
.
location
error
.
location
.
field_path_elements
.
each
do
|
field_path_element
|
STDERR
.
printf
(
"
\t
On field: %s
\n
"
,
field_path_element
.
field_name
)
end
end
error
.
error_code
.
to_h
.
each
do
|
k
,
v
|
next
if
v
==
:UNSPECIFIED
STDERR
.
printf
(
"
\t
Type: %s
\n\t
Code: %s
\n
"
,
k
,
v
)
end
end
raise
end
end
Perl
#!/usr/bin/perl -w
#
# Copyright 2022, Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# This example adds a call asset to a specific account.
use
strict
;
use
warnings
;
use
utf8
;
use
FindBin
qw($Bin)
;
use
lib
"$Bin/../../lib"
;
use
Google::Ads::GoogleAds::Client
;
use
Google::Ads::GoogleAds::Utils::GoogleAdsHelper
;
use
Google::Ads::GoogleAds::V21::Resources::Asset
;
use
Google::Ads::GoogleAds::V21::Resources::CustomerAsset
;
use
Google::Ads::GoogleAds::V21::Common::CallAsset
;
use
Google::Ads::GoogleAds::V21::Common::AdScheduleInfo
;
use
Google::Ads::GoogleAds::V21::Enums::DayOfWeekEnum
qw(MONDAY)
;
use
Google::Ads::GoogleAds::V21::Enums::MinuteOfHourEnum
qw(ZERO)
;
use
Google::Ads::GoogleAds::V21::Enums::CallConversionReportingStateEnum
qw(USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION)
;
use
Google::Ads::GoogleAds::V21::Enums::AssetFieldTypeEnum
qw(CALL)
;
use
Google::Ads::GoogleAds::V21::Services::AssetService::AssetOperation
;
use
Google::Ads::GoogleAds::V21::Services::CustomerAssetService::CustomerAssetOperation
;
use
Google::Ads::GoogleAds::V21::Utils::ResourceNames
;
use
Getopt::Long
qw(:config auto_help)
;
use
Pod::Usage
;
use
Cwd
qw(abs_path)
;
# The following parameter(s) should be provided to run the example. You can
# either specify these by changing the INSERT_XXX_ID_HERE values below, or on
# the command line.
#
# Parameters passed on the command line will override any parameters set in
# code.
#
# Running the example with -h will print the command line usage.
my
$customer_id
=
"INSERT_CUSTOMER_ID_HERE"
;
# Specify the phone country code here or the default specified below will be used.
# See supported codes at:
# https://developers.google.com/google-ads/api/reference/data/codes-formats#expandable-17
my
$phone_country
=
"US"
;
my
$phone_number
=
"INSERT_PHONE_NUMBER_HERE"
;
# Optional: Specify the conversion action ID to attribute call conversions to.
# If not set, the default conversion action is used.
my
$conversion_action_id
=
undef
;
sub
add_call
{
my
(
$api_client
,
$customer_id
,
$phone_country
,
$phone_number
,
$conversion_action_id
)
=
@_
;
# Create the call asset.
my
$asset_resource_name
=
add_call_asset
(
$api_client
,
$customer_id
,
$phone_country
,
$phone_number
,
$conversion_action_id
);
# Add the assets at the account level, so these will serve in all eligible campaigns.
link_asset_to_account
(
$api_client
,
$customer_id
,
$asset_resource_name
);
return
1
;
}
# Creates a new asset for the call.
sub
add_call_asset
{
my
(
$api_client
,
$customer_id
,
$phone_country
,
$phone_number
,
$conversion_action_id
)
=
@_
;
# Create the call asset.
my
$call_asset
=
Google::Ads::GoogleAds::V21::Common::
CallAsset
-
> new
({
# Set the country code and phone number of the business to call.
countryCode
=
>
$phone_country
,
phoneNumber
=
>
$phone_number
,
# Optional: Specify all day and time intervals for which the asset may serve.
adScheduleTargets
=
>
[
Google::Ads::GoogleAds::V21::Common::
AdScheduleInfo
-
> new
({
# Set the day of this schedule as Monday.
dayOfWeek
=
>
MONDAY
,
# Set the start hour to 9am.
startHour
=
>
9
,
# Set the end hour to 5pm.
endHour
=
>
17
,
# Set the start and end minute of zero, for example: 9:00 and 5:00.
startMinute
=
>
ZERO
,
endMinute
=
>
ZERO
})]});
# Set the conversion action ID to the one provided if any.
if
(
defined
$conversion_action_id
)
{
$call_asset
-
> {
callConversionAction
}
=
Google::Ads::GoogleAds::V21::Utils::ResourceNames::
conversion_action
(
$customer_id
,
$conversion_action_id
);
$call_asset
-
> {
callConversionReportingState
}
=
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION
;
}
# Create an asset operation wrapping the call asset in an asset.
my
$asset_operation
=
Google::Ads::GoogleAds::V21::Services::AssetService::
AssetOperation
-
> new
({
create
=
>
Google::Ads::GoogleAds::V21::Resources::
Asset
-
> new
({
callAsset
=
>
$call_asset
})});
# Issue a mutate request to add the asset and print its information.
my
$response
=
$api_client
-
> AssetService
()
-
> mutate
({
customerId
=
>
$customer_id
,
operations
=
>
[
$asset_operation
]});
my
$resource_name
=
$response
-
> {
results
}[
0
]{
resourceName
};
printf
"Created a call asset with resource name: '%s'.\n"
,
$resource_name
;
return
$resource_name
;
}
# Links the call asset at the account level to serve in all eligible campaigns.
sub
link_asset_to_account
{
my
(
$api_client
,
$customer_id
,
$asset_resource_name
)
=
@_
;
# Create a customer asset operation wrapping the call asset in a customer asset.
my
$customer_asset_operation
=
Google::Ads::GoogleAds::V21::Services::CustomerAssetService::
CustomerAssetOperation
-
> new
({
create
=
>
Google::Ads::GoogleAds::V21::Resources::
CustomerAsset
-
> new
({
asset
=
>
$asset_resource_name
,
fieldType
=
>
CALL
})});
# Issue a mutate request to add the customer asset and print its information.
my
$response
=
$api_client
-
> CustomerAssetService
()
-
> mutate
({
customerId
=
>
$customer_id
,
operations
=
>
[
$customer_asset_operation
]});
printf
"Created a customer asset with resource name: '%s'.\n"
,
$response
-
> {
results
}[
0
]{
resourceName
};
}
# Don't run the example if the file is being included.
if
(
abs_path
(
$0
)
ne
abs_path
(
__FILE__
))
{
return
1
;
}
# Get Google Ads Client, credentials will be read from ~/googleads.properties.
my
$api_client
=
Google::Ads::GoogleAds::
Client
-
> new
();
# By default examples are set to die on any server returned fault.
$api_client
-
> set_die_on_faults
(
1
);
# Parameters passed on the command line will override any parameters set in code.
GetOptions
(
"customer_id=s"
=
>
\
$customer_id
,
"phone_country=s"
=
>
\
$phone_country
,
"phone_number=s"
=
>
\
$phone_number
,
"conversion_action_id=i"
=
>
\
$conversion_action_id
);
# Print the help message if the parameters are not initialized in the code nor
# in the command line.
pod2usage
(
2
)
if
not
check_params
(
$customer_id
,
$phone_country
,
$phone_number
);
# Call the example.
add_call
(
$api_client
,
$customer_id
=~
s/-//g
r
,
$phone_country
,
$phone_number
,
$conversion_action_id
);
=pod
=head1 NAME
add_call
=head1 DESCRIPTION
This example adds a call asset to a specific account.
=head1 SYNOPSIS
add_call.pl [options]
-help Show the help message.
-customer_id The Google Ads customer ID.
-phone_country [optional] The phone country (2-letter code).
-phone_number The raw phone number, e.g. "(800) 555-0100".
-conversion_action_id [optional] The conversion action ID to attribute conversions to.
=cut
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eThe code snippets demonstrate how to add a call asset to a Google Ads account, enabling businesses to display their phone number in ads for direct customer calls.\u003c/p\u003e\n"],["\u003cp\u003eThe examples cover implementation in various programming languages, including Java, C#, PHP, Python, Ruby, and Perl, using respective Google Ads API client libraries.\u003c/p\u003e\n"],["\u003cp\u003eCall assets can be configured with optional scheduling and conversion tracking to control display times and measure call conversions.\u003c/p\u003e\n"],["\u003cp\u003eThe code handles potential errors during asset creation and linking processes, ensuring robust functionality.\u003c/p\u003e\n"],["\u003cp\u003eBy linking the call asset to a Google Ads account, businesses can utilize it in eligible ad campaigns to drive customer engagement.\u003c/p\u003e\n"]]],[],null,[]]
