4.3.2 אפשרות חיוב מאוחד
בתרשים הבא מוצגת דרך מומלצת לארגון חשבונות ניהול וחשבונות מפרסמים ב-Google Ads.
ההערות הבאות מתייחסות למספרים בתרשים שלמעלה:
בחשבון מאוחד (CB) יש מגבלה של 15,000 על מספר החשבונות או החשבוניות שאפשר להוסיף. אם החיוב המאוחד הראשון (CB US1) מגיע ל-15,000 חשבוניות או חשבונות, צריך להוסיף את כל החשבוניות או החשבונות העתידיים אל CBUS2.
אפשר להגדיר חיוב מאוחד בחשבון הניהול באמצעות טופס הבקשה לחיוב מאוחד. קודם כול צריך להיות לכם קו אשראי מאושר מ-Google. אם עדיין לא עשיתם זאת, תוכלו לבקש אותו באמצעות הטופס ליצירת קשר עם Google.
אפשר להעביר חשבונות לא פעילים (שננטשו) לחשבון ניהול אחר. עם הפרדת החשבונות תוכלו לעמוד במגבלת 15,000 החשבונות. ליתר ביטחון, מומלץ להסיר את סדר הקצאת התקציב של החשבונות האלה כדי שהם לא יוכלו להמשיך לצבור הוצאות אלא אם הם יופעלו מחדש באופן ידני.
אם השילוב מאפשר למשתמשים להשתמש בחשבונות Google Ads קיימים, צריך ליצור חשבון ניהול נפרד עבורם. אי אפשר להשתמש בחיוב מאוחד בחשבונות קיימים, כי יכול להיות שהם כבר מוציאים על קמפיינים מסוגים אחרים וסביר להניח שכבר מוגדרים בהם חיוב ישיר.
כדי להגדיר חיוב מאוחד ישירות בממשק המשתמש של Google Ads, פועלים לפי ההוראות במאמר הגדרת חיוב מאוחד.
הדרכה טכנית
כדי להגדיר ולנהל את החיוב בחשבונות Google Ads של מוכרים באמצעות ה-API, תוכלו להשתמש במשאבים של BillingSetup כדי לקבל ולנהל את הגדרות החיוב בחשבון כולו. הגדרת חיוב היא שיוך בין חשבון תשלומים לחשבון Google Ads ספציפי. בעזרת המדד הזה,
המערכת קובעת באופן יעיל מי משלם על החשבון של המפרסם. פועלים לפי ההוראות להגדרת החיוב.
ניהול תקציבי החשבון
בתקציב החשבון מוגדרים מאפייני תקציב ברמת החשבון, כמו שעת התחלה, שעת סיום ותקרת הוצאות. כדי לבצע שינויים בתקציב החשבון, אנחנו שולחים הצעות נפרדות לתקציב החשבון. הצעות כאלה הופכות אחרי שאנחנו בודקים ומאושרים לתקציב החשבון. השתמשו במשאבים של AccountBudgetProposal כדי ליצור AccountBudgets חדשים או לעדכן דומיינים קיימים.
הדוגמאות הבאות מראות כיצד ליצור הצעת תקציב חדשה:
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId, long billingSetupId) {
// Creates an AccountBudgetProposal. This will be reviewed offline by Google Ads, and if
// approved will become an AccountBudget.
AccountBudgetProposal proposal =
AccountBudgetProposal.newBuilder()
.setBillingSetup(ResourceNames.billingSetup(customerId, billingSetupId))
.setProposalType(AccountBudgetProposalType.CREATE)
.setProposedName("Account Budget (example)")
// Specifies the account budget starts immediately.
.setProposedStartTimeType(TimeType.NOW)
// Alternatively you can specify a specific start time. Refer to the
// AccountBudgetProposal
// resource documentation for allowed formats.
//
// .setProposedStartDateTime("2020-01-02 03:04:05")
// Specifies that the budget runs forever.
.setProposedEndTimeType(TimeType.FOREVER)
// Alternatively you can specify a specific end time. Allowed formats are as above.
// .setProposedEndDateTime("2021-02-03 04:05:06")
// Optional: sets notes for the budget. These are free text and do not effect budget
// delivery.
// .setProposedNotes("Received prepayment of $0.01")
// Sets the spending limit to 0.01, measured in the Google Ads account currency.
.setProposedSpendingLimitMicros(10_000)
// Optional: sets PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
// .setProposedPurchaseOrderNumber("PO number 12345")
.build();
// Creates an operation which will add the new AccountBudgetProposal.
AccountBudgetProposalOperation operation =
AccountBudgetProposalOperation.newBuilder().setCreate(proposal).build();
try (AccountBudgetProposalServiceClient accountBudgetProposalServiceClient =
googleAdsClient.getLatestVersion().createAccountBudgetProposalServiceClient()) {
// Sends the request to the Account Budget Proposal Service.
MutateAccountBudgetProposalResponse response =
accountBudgetProposalServiceClient.mutateAccountBudgetProposal(
String.valueOf(customerId), operation);
System.out.printf(
"Account budget proposal created: %s.%n", response.getResult().getResourceName());
}
}
C#
public void Run(GoogleAdsClient client, long customerId, long billingSetupId)
{
// Get the AccountBudgetProposalServiceClient.
AccountBudgetProposalServiceClient proposalService =
client.GetService(Services.V17.AccountBudgetProposalService);
// Create an AccountBudgetProposal. The proposal will be reviewed offline by Google Ads,
// and if approved will become an AccountBudget.
AccountBudgetProposal proposal = new AccountBudgetProposal()
{
BillingSetup = ResourceNames.BillingSetup(customerId, billingSetupId),
ProposalType = AccountBudgetProposalType.Create,
ProposedName = "Account Budget (example)",
// Specify the account budget starts immediately
ProposedStartTimeType = TimeType.Now,
// Alternatively, you can specify a specific start time. Refer to the
// AccountBudgetProposal resource documentation for allowed formats.
//
//ProposedStartDateTime = "2020-01-02 03:04:05",
// Specify that the budget runs forever.
ProposedEndTimeType = TimeType.Forever,
// Alternatively you can specify a specific end time. Allowed formats are as above.
//ProposedEndDateTime = "2021-02-03 04:05:06",
// Optional: set notes for the budget. These are free text and do not effect budget
// delivery.
//ProposedNotes = "Received prepayment of $0.01",
// Set the spending limit to 0.01, measured in the Google Ads account currency.
ProposedSpendingLimitMicros = 10_000
// Optional: set PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
//ProposedPurchaseOrderNumber = "PO number 12345"
};
// Create an operation which will add the new AccountBudgetProposal
AccountBudgetProposalOperation operation = new AccountBudgetProposalOperation()
{
Create = proposal
};
try
{
// Send the request to the Account Budget Proposal Service.
MutateAccountBudgetProposalResponse response = proposalService.
MutateAccountBudgetProposal(customerId.ToString(), operation);
// Display the results.
Console.WriteLine($"Account budget proposal '{response.Result.ResourceName}' " +
"was created.");
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
PHP
public static function runExample(
GoogleAdsClient $googleAdsClient,
int $customerId,
int $billingSetupId
) {
// Constructs an account budget proposal.
$accountBudgetProposal = new AccountBudgetProposal([
'billing_setup' => ResourceNames::forBillingSetup($customerId, $billingSetupId),
'proposal_type' => AccountBudgetProposalType::CREATE,
'proposed_name' => 'Account Budget (example)',
// Specifies the account budget starts immediately.
'proposed_start_time_type' => TimeType::NOW,
// Alternatively you can specify a specific start time. Refer to the
// AccountBudgetProposal class for allowed formats.
//
// 'proposed_start_date_time' => '2020-01-02 03:04:05',
// Specify that the budget runs forever.
'proposed_end_time_type' => TimeType::FOREVER,
// Alternatively you can specify a specific end time. Allowed formats are as above.
// 'proposed_end_date_time' => '2021-02-03 04:05:06',
// Optional: set notes for the budget. These are free text and do not effect budget
// delivery.
// 'proposed_notes' => 'Received prepayment of $0.01',
// Optional: set PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
// 'proposed_purchase_order_number' => 'PO number 12345',
// Set the spending limit to 0.01, measured in the Google Ads account currency.
'proposed_spending_limit_micros' => 10000
]);
$accountBudgetProposalOperation = new AccountBudgetProposalOperation();
$accountBudgetProposalOperation->setCreate($accountBudgetProposal);
// Issues a mutate request to add the account budget proposal.
$accountBudgetProposalServiceClient =
$googleAdsClient->getAccountBudgetProposalServiceClient();
$response = $accountBudgetProposalServiceClient->mutateAccountBudgetProposal(
MutateAccountBudgetProposalRequest::build($customerId, $accountBudgetProposalOperation)
);
printf(
"Added an account budget proposal with resource name '%s'.%s",
$response->getResult()->getResourceName(),
PHP_EOL
);
}
Python
def main(client, customer_id, billing_setup_id):
account_budget_proposal_service = client.get_service(
"AccountBudgetProposalService"
)
billing_setup_service = client.get_service("BillingSetupService")
account_budget_proposal_operation = client.get_type(
"AccountBudgetProposalOperation"
)
proposal = account_budget_proposal_operation.create
proposal.proposal_type = client.enums.AccountBudgetProposalTypeEnum.CREATE
proposal.billing_setup = billing_setup_service.billing_setup_path(
customer_id, billing_setup_id
)
proposal.proposed_name = "Account Budget Proposal (example)"
# Specify the account budget starts immediately
proposal.proposed_start_time_type = client.enums.TimeTypeEnum.NOW
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal resource documentation for allowed formats.
#
# proposal.proposed_start_date_time = '2020-01-02 03:04:05'
# Specify that the budget runs forever
proposal.proposed_end_time_type = client.enums.TimeTypeEnum.FOREVER
# Alternatively you can specify a specific end time. Allowed formats are as
# above.
#
# proposal.proposed_end_date_time = '2021-01-02 03:04:05'
# Optional: set notes for the budget. These are free text and do not effect
# budget delivery.
#
# proposal.proposed_notes = 'Received prepayment of $0.01'
proposal.proposed_spending_limit_micros = 10000
account_budget_proposal_response = (
account_budget_proposal_service.mutate_account_budget_proposal(
customer_id=customer_id,
operation=account_budget_proposal_operation,
)
)
print(
"Created account budget proposal "
f'"{account_budget_proposal_response.result.resource_name}".'
)
Ruby
def add_account_budget_proposal(customer_id, billing_setup_id)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
operation = client.operation.create_resource.account_budget_proposal do |proposal|
proposal.billing_setup = client.path.billing_setup(customer_id, billing_setup_id)
proposal.proposal_type = :CREATE
proposal.proposed_name = 'Account Budget (example)'
# Specify the account budget starts immediately
proposal.proposed_start_time_type = :NOW
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal resource documentation for allowed formats.
#
# proposal.proposed_start_date_time = '2020-01-02 03:04:05'
# Specify that the budget runs forever.
proposal.proposed_end_time_type = :FOREVER
# Alternatively you can specify a specific end time. Allowed formats are as
# above.
#
# proposal.proposed_end_date_time = '2021-01-02 03:04:05'
# Optional: set notes for the budget. These are free text and do not affect
# budget delivery.
#
# proposal.proposed_notes = 'Received prepayment of $0.01'
# Set the spending limit to 0.01, measured in the Google Ads account currency.
proposal.proposed_spending_limit_micros = 10_000
end
account_budget_proposal_service = client.service.account_budget_proposal
# Add budget proposal.
response = account_budget_proposal_service.mutate_account_budget_proposal(
customer_id: customer_id,
operation: operation,
)
puts sprintf("Created budget proposal %s.",
response.results.first.resource_name)
end
Perl
sub add_account_budget_proposal {
my ($api_client, $customer_id, $billing_setup_id) = @_;
# Create an account budget proposal.
my $account_budget_proposal =
Google::Ads::GoogleAds::V17::Resources::AccountBudgetProposal->new({
billingSetup =>
Google::Ads::GoogleAds::V17::Utils::ResourceNames::billing_setup(
$customer_id, $billing_setup_id
),
proposalType => CREATE,
proposedName => "Account Budget (example)",
# Specify that the account budget starts immediately.
proposedStartTimeType => NOW,
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal class for allowed formats.
#
# proposedStartDateTime => "2020-01-02 03:04:05",
# Specify that the account budget runs forever.
proposedEndDateTime => FOREVER,
# Alternatively you can specify a specific end time. Allowed formats are as below.
# proposedEndDateTime => "2021-02-03 04:05:06",
# Optional: set notes for the budget. These are free text and do not effect budget
# delivery.
# proposedNotes => "Received prepayment of $0.01",
# Optional: set PO number for record keeping. This value is at the user's
# discretion, and has no effect on Google Billing & Payments.
# proposedPurchaseOrderNumber => "PO number 12345",
# Set the spending limit to 0.01, measured in the Google Ads account currency.
proposedSpendingLimitMicros => 10000
});
# Create an account budget proposal operation.
my $account_budget_proposal_operation =
Google::Ads::GoogleAds::V17::Services::AccountBudgetProposalService::AccountBudgetProposalOperation
->new({
create => $account_budget_proposal
});
# Add the account budget proposal.
my $account_budget_proposal_response =
$api_client->AccountBudgetProposalService()->mutate({
customerId => $customer_id,
operation => $account_budget_proposal_operation
});
printf "Created account budget proposal '%s'.\n",
$account_budget_proposal_response->{result}{resourceName};
return 1;
}
כדי לעדכן את תקציבי החשבון, משתמשים ב-AccountBudgetProposalService כדי לנהל את הפרמטרים של התקציב. פעולות הניהול הנפוצות ביותר הן עדכון השדות של תקרת ההוצאה ותאריך השעה. כאן מופיעה רשימה מלאה של השדות שניתנים לשינוי: AccountBudgetProposal. בדוגמה הבאה אפשר לראות איך מעדכנים את תקרת ההוצאות המוצעת בתקציב חשבון קיים.
Java
private void runExample(GoogleAdsClient googleAdsClient, long customerId, long billingSetupId) {
// Creates an AccountBudgetProposal. This will be reviewed offline by Google Ads, and if
// approved will become an AccountBudget.
AccountBudgetProposal proposal =
AccountBudgetProposal.newBuilder()
.setBillingSetup(ResourceNames.billingSetup(customerId, billingSetupId))
.setProposalType(AccountBudgetProposalType.CREATE)
.setProposedName("Account Budget (example)")
// Specifies the account budget starts immediately.
.setProposedStartTimeType(TimeType.NOW)
// Alternatively you can specify a specific start time. Refer to the
// AccountBudgetProposal
// resource documentation for allowed formats.
//
// .setProposedStartDateTime("2020-01-02 03:04:05")
// Specifies that the budget runs forever.
.setProposedEndTimeType(TimeType.FOREVER)
// Alternatively you can specify a specific end time. Allowed formats are as above.
// .setProposedEndDateTime("2021-02-03 04:05:06")
// Optional: sets notes for the budget. These are free text and do not effect budget
// delivery.
// .setProposedNotes("Received prepayment of $0.01")
// Sets the spending limit to 0.01, measured in the Google Ads account currency.
.setProposedSpendingLimitMicros(10_000)
// Optional: sets PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
// .setProposedPurchaseOrderNumber("PO number 12345")
.build();
// Creates an operation which will add the new AccountBudgetProposal.
AccountBudgetProposalOperation operation =
AccountBudgetProposalOperation.newBuilder().setCreate(proposal).build();
try (AccountBudgetProposalServiceClient accountBudgetProposalServiceClient =
googleAdsClient.getLatestVersion().createAccountBudgetProposalServiceClient()) {
// Sends the request to the Account Budget Proposal Service.
MutateAccountBudgetProposalResponse response =
accountBudgetProposalServiceClient.mutateAccountBudgetProposal(
String.valueOf(customerId), operation);
System.out.printf(
"Account budget proposal created: %s.%n", response.getResult().getResourceName());
}
}
C#
public void Run(GoogleAdsClient client, long customerId, long billingSetupId)
{
// Get the AccountBudgetProposalServiceClient.
AccountBudgetProposalServiceClient proposalService =
client.GetService(Services.V17.AccountBudgetProposalService);
// Create an AccountBudgetProposal. The proposal will be reviewed offline by Google Ads,
// and if approved will become an AccountBudget.
AccountBudgetProposal proposal = new AccountBudgetProposal()
{
BillingSetup = ResourceNames.BillingSetup(customerId, billingSetupId),
ProposalType = AccountBudgetProposalType.Create,
ProposedName = "Account Budget (example)",
// Specify the account budget starts immediately
ProposedStartTimeType = TimeType.Now,
// Alternatively, you can specify a specific start time. Refer to the
// AccountBudgetProposal resource documentation for allowed formats.
//
//ProposedStartDateTime = "2020-01-02 03:04:05",
// Specify that the budget runs forever.
ProposedEndTimeType = TimeType.Forever,
// Alternatively you can specify a specific end time. Allowed formats are as above.
//ProposedEndDateTime = "2021-02-03 04:05:06",
// Optional: set notes for the budget. These are free text and do not effect budget
// delivery.
//ProposedNotes = "Received prepayment of $0.01",
// Set the spending limit to 0.01, measured in the Google Ads account currency.
ProposedSpendingLimitMicros = 10_000
// Optional: set PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
//ProposedPurchaseOrderNumber = "PO number 12345"
};
// Create an operation which will add the new AccountBudgetProposal
AccountBudgetProposalOperation operation = new AccountBudgetProposalOperation()
{
Create = proposal
};
try
{
// Send the request to the Account Budget Proposal Service.
MutateAccountBudgetProposalResponse response = proposalService.
MutateAccountBudgetProposal(customerId.ToString(), operation);
// Display the results.
Console.WriteLine($"Account budget proposal '{response.Result.ResourceName}' " +
"was created.");
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
PHP
public static function runExample(
GoogleAdsClient $googleAdsClient,
int $customerId,
int $billingSetupId
) {
// Constructs an account budget proposal.
$accountBudgetProposal = new AccountBudgetProposal([
'billing_setup' => ResourceNames::forBillingSetup($customerId, $billingSetupId),
'proposal_type' => AccountBudgetProposalType::CREATE,
'proposed_name' => 'Account Budget (example)',
// Specifies the account budget starts immediately.
'proposed_start_time_type' => TimeType::NOW,
// Alternatively you can specify a specific start time. Refer to the
// AccountBudgetProposal class for allowed formats.
//
// 'proposed_start_date_time' => '2020-01-02 03:04:05',
// Specify that the budget runs forever.
'proposed_end_time_type' => TimeType::FOREVER,
// Alternatively you can specify a specific end time. Allowed formats are as above.
// 'proposed_end_date_time' => '2021-02-03 04:05:06',
// Optional: set notes for the budget. These are free text and do not effect budget
// delivery.
// 'proposed_notes' => 'Received prepayment of $0.01',
// Optional: set PO number for record keeping. This value is at the user's
// discretion, and has no effect on Google Billing & Payments.
// 'proposed_purchase_order_number' => 'PO number 12345',
// Set the spending limit to 0.01, measured in the Google Ads account currency.
'proposed_spending_limit_micros' => 10000
]);
$accountBudgetProposalOperation = new AccountBudgetProposalOperation();
$accountBudgetProposalOperation->setCreate($accountBudgetProposal);
// Issues a mutate request to add the account budget proposal.
$accountBudgetProposalServiceClient =
$googleAdsClient->getAccountBudgetProposalServiceClient();
$response = $accountBudgetProposalServiceClient->mutateAccountBudgetProposal(
MutateAccountBudgetProposalRequest::build($customerId, $accountBudgetProposalOperation)
);
printf(
"Added an account budget proposal with resource name '%s'.%s",
$response->getResult()->getResourceName(),
PHP_EOL
);
}
Python
def main(client, customer_id, billing_setup_id):
account_budget_proposal_service = client.get_service(
"AccountBudgetProposalService"
)
billing_setup_service = client.get_service("BillingSetupService")
account_budget_proposal_operation = client.get_type(
"AccountBudgetProposalOperation"
)
proposal = account_budget_proposal_operation.create
proposal.proposal_type = client.enums.AccountBudgetProposalTypeEnum.CREATE
proposal.billing_setup = billing_setup_service.billing_setup_path(
customer_id, billing_setup_id
)
proposal.proposed_name = "Account Budget Proposal (example)"
# Specify the account budget starts immediately
proposal.proposed_start_time_type = client.enums.TimeTypeEnum.NOW
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal resource documentation for allowed formats.
#
# proposal.proposed_start_date_time = '2020-01-02 03:04:05'
# Specify that the budget runs forever
proposal.proposed_end_time_type = client.enums.TimeTypeEnum.FOREVER
# Alternatively you can specify a specific end time. Allowed formats are as
# above.
#
# proposal.proposed_end_date_time = '2021-01-02 03:04:05'
# Optional: set notes for the budget. These are free text and do not effect
# budget delivery.
#
# proposal.proposed_notes = 'Received prepayment of $0.01'
proposal.proposed_spending_limit_micros = 10000
account_budget_proposal_response = (
account_budget_proposal_service.mutate_account_budget_proposal(
customer_id=customer_id,
operation=account_budget_proposal_operation,
)
)
print(
"Created account budget proposal "
f'"{account_budget_proposal_response.result.resource_name}".'
)
Ruby
def add_account_budget_proposal(customer_id, billing_setup_id)
# GoogleAdsClient will read a config file from
# ENV['HOME']/google_ads_config.rb when called without parameters
client = Google::Ads::GoogleAds::GoogleAdsClient.new
operation = client.operation.create_resource.account_budget_proposal do |proposal|
proposal.billing_setup = client.path.billing_setup(customer_id, billing_setup_id)
proposal.proposal_type = :CREATE
proposal.proposed_name = 'Account Budget (example)'
# Specify the account budget starts immediately
proposal.proposed_start_time_type = :NOW
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal resource documentation for allowed formats.
#
# proposal.proposed_start_date_time = '2020-01-02 03:04:05'
# Specify that the budget runs forever.
proposal.proposed_end_time_type = :FOREVER
# Alternatively you can specify a specific end time. Allowed formats are as
# above.
#
# proposal.proposed_end_date_time = '2021-01-02 03:04:05'
# Optional: set notes for the budget. These are free text and do not affect
# budget delivery.
#
# proposal.proposed_notes = 'Received prepayment of $0.01'
# Set the spending limit to 0.01, measured in the Google Ads account currency.
proposal.proposed_spending_limit_micros = 10_000
end
account_budget_proposal_service = client.service.account_budget_proposal
# Add budget proposal.
response = account_budget_proposal_service.mutate_account_budget_proposal(
customer_id: customer_id,
operation: operation,
)
puts sprintf("Created budget proposal %s.",
response.results.first.resource_name)
end
Perl
sub add_account_budget_proposal {
my ($api_client, $customer_id, $billing_setup_id) = @_;
# Create an account budget proposal.
my $account_budget_proposal =
Google::Ads::GoogleAds::V17::Resources::AccountBudgetProposal->new({
billingSetup =>
Google::Ads::GoogleAds::V17::Utils::ResourceNames::billing_setup(
$customer_id, $billing_setup_id
),
proposalType => CREATE,
proposedName => "Account Budget (example)",
# Specify that the account budget starts immediately.
proposedStartTimeType => NOW,
# Alternatively you can specify a specific start time. Refer to the
# AccountBudgetProposal class for allowed formats.
#
# proposedStartDateTime => "2020-01-02 03:04:05",
# Specify that the account budget runs forever.
proposedEndDateTime => FOREVER,
# Alternatively you can specify a specific end time. Allowed formats are as below.
# proposedEndDateTime => "2021-02-03 04:05:06",
# Optional: set notes for the budget. These are free text and do not effect budget
# delivery.
# proposedNotes => "Received prepayment of $0.01",
# Optional: set PO number for record keeping. This value is at the user's
# discretion, and has no effect on Google Billing & Payments.
# proposedPurchaseOrderNumber => "PO number 12345",
# Set the spending limit to 0.01, measured in the Google Ads account currency.
proposedSpendingLimitMicros => 10000
});
# Create an account budget proposal operation.
my $account_budget_proposal_operation =
Google::Ads::GoogleAds::V17::Services::AccountBudgetProposalService::AccountBudgetProposalOperation
->new({
create => $account_budget_proposal
});
# Add the account budget proposal.
my $account_budget_proposal_response =
$api_client->AccountBudgetProposalService()->mutate({
customerId => $customer_id,
operation => $account_budget_proposal_operation
});
printf "Created account budget proposal '%s'.\n",
$account_budget_proposal_response->{result}{resourceName};
return 1;
}
כדי לסיים תקציב של חשבון פעיל, עליכם להגדיר את שעת הסיום לשעה הנוכחית על ידי שליחת הצעה עם AccountBudgetProposalType.END.
הנפקת חשבוניות
החשבונית מונפקת מדי חודש כאשר המפרסם מפעיל אותה. החשבוניות כוללות פרטים כמו התאמות, עלויות רגולטוריות, מיסים ותקציבי חשבון, ואפשר להוריד אותן כקובצי PDF. כמנהלים, אתם בדרך כלל משתמשים בהם כדי להתאים את החשבוניות של הלקוחות באופן אוטומטי. כדי להפעיל חיוב, צריך:
להפעיל חיוב חודשי בחשבון Google Ads. במדריכים לגבי הגדרות החיוב ותקציבים בחשבון מוסבר איך לנהל את החיוב באמצעות Google Ads API.
אם השדה מוגדר,
login-customer-idחייב לציין את מספר הלקוח של חשבון הניהול שמנהל את חשבון Google Ads שעבורו אתם מאחזרים חשבוניות. חשבון זה מסומן בתור חשבון הניהול שדרכו מתבצע התשלום בממשק המשתמש של Google Ads.
אחזור של Invoice משאבים לנתוני חשבוניות באמצעות InvoiceService. מבקשים את השיטה InvoiceService.ListInvoices, ומגדירים את כל שדות החובה ב-ListInvoicesRequest:
customer_id, billing_setup, issue_year ו-issue_month. הדוגמאות הבאות מראות איך להגיש את הבקשה הזו:
Java
// Issues the request.
ListInvoicesResponse response =
invoiceServiceClient.listInvoices(
String.valueOf(customerId),
ResourceNames.billingSetup(customerId, billingSetupId),
String.valueOf(oneMonthAgo.getYear()),
MonthOfYear.valueOf(oneMonthAgo.getMonth().toString()));
C#
ListInvoicesResponse response = invoiceServiceClient.ListInvoices(customerId.ToString(),
ResourceNames.BillingSetup(customerId, billingSetupId),
// Year must be 2019 or later.
lastMonthDateTime.Year.ToString("yyyy"),
lastMonth);
PHP
// Issues the request.
$response = $googleAdsClient->getInvoiceServiceClient()->listInvoices(
ListInvoicesRequest::build(
$customerId,
ResourceNames::forBillingSetup($customerId, $billingSetupId),
// The year needs to be 2019 or later.
date('Y', $lastMonth),
MonthOfYear::value(strtoupper(date('F', $lastMonth)))
)
);
Python
# Issues a request to list invoices.
response = client.get_service("InvoiceService").list_invoices(
customer_id=customer_id,
billing_setup=client.get_service("GoogleAdsService").billing_setup_path(
customer_id, billing_setup_id
),
# The year needs to be 2019 or later, per the docs:
# https://developers.google.com/google-ads/api/docs/billing/invoice?hl=en#retrieving_invoices
issue_year=str(last_month.year),
issue_month=last_month.strftime("%B").upper(),
)
Ruby
# Issues a request to list invoices.
response = client.service.invoice.list_invoices(
customer_id: customer_id,
billing_setup: client.path.billing_setup(customer_id, billing_setup_id),
# The year needs to be 2019 or later.
issue_year: last_month.year.to_s,
# '%^B' option returns the uppercased full month name (e.g. 'JANUARY').
issue_month: last_month.strftime("%^B").to_sym,
)
Perl
# Issue the request.
my $response = $api_client->InvoiceService()->list({
customerId => $customer_id,
billingSetup =>
Google::Ads::GoogleAds::V17::Utils::ResourceNames::billing_setup(
($customer_id, $billing_setup_id)
),
# The year needs to be 2019 or later.
issueYear => strftime("%Y", @last_month),
issueMonth => uc(strftime("%B", @last_month))});
התשובה היא אובייקט ListInvoicesResponse שמכיל את רשימת
הערכים התואמים Invoices. בחשבונית משולבים נתונים מכל חשבונות Google Ads עם הגדרות חיוב שמשתמשות באותו חשבון תשלומים בסיסי כמו זה ששימש להגדרת החיוב המבוקשת. זה קורה רק כשחשבון Payments בסיסי עומד בדרישות לשימוש בחיוב מאוחד.