Method: customers.accountBudgetProposals.mutate

Tworzy, aktualizuje lub usuwa propozycje budżetu konta. Zwracane są stany operacji.

Lista zgłoszonych błędów: AccountBudgetProposalError AuthenticationError AuthorizationError DatabaseError DateError FieldError FieldMaskError HeaderError InternalError MutateError QuotaErrorRequestErrorStringLengthError

Żądanie HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/accountBudgetProposals:mutate

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customerId

string

To pole jest wymagane. Identyfikator klienta.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "operation": {
    object (AccountBudgetProposalOperation)
  },
  "validateOnly": boolean
}
Pola
operation

object (AccountBudgetProposalOperation)

To pole jest wymagane. Operacja wykonywana na pojedynczej propozycji budżetu na poziomie konta.
validateOnly

boolean

Jeśli ma wartość true (prawda), żądanie jest sprawdzane, ale nie wykonywane. Zwracane są tylko błędy, a nie wyniki.

Treść odpowiedzi

Komunikat z odpowiedzią na operacje zmiany budżetu na poziomie konta.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "result": {
    object (MutateAccountBudgetProposalResult)
  }
}
Pola
result

object (MutateAccountBudgetProposalResult)

Wynik mutacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/adwords

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AccountBudgetProposalOperation

Pojedyncza operacja, która ma na celu proponowanie utworzenia nowego budżetu na poziomie konta lub zmiany/zakończenia/usunięcia już istniejącego.

Zapis JSON 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (AccountBudgetProposal)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Pola
updateMask

string (FieldMask format)

Maska FieldMask określająca, które pola budżetu są modyfikowane. Budżety mogą być modyfikowane, ale propozycje takie są ostateczne. Z tego powodu operacje aktualizacji nie są obsługiwane w przypadku ofert pakietowych.

Oferty pakietowe, które modyfikują budżety, mają typ „aktualizacja”. Określanie maski w przypadku innego typu oferty pakietowej jest uznawane za błąd.

Jest to lista rozdzielonych przecinkami pełnych i jednoznacznych nazw pól. Przykład: "user.displayName,photo".
Pole sumy operation. Operacja zmiany. operation może mieć tylko jedną z tych wartości:
create

object (AccountBudgetProposal)

Operacja tworzenia: nowa oferta pakietowa, która umożliwia utworzenie nowego budżetu, zmianę istniejącego budżetu, zakończenie aktywnego budżetu lub usunięcie zatwierdzonego budżetu z przyszłą datą rozpoczęcia. W nowej ofercie pakietowej nie ma nazwy zasobu.
remove

string

Operacja usuwania: oczekiwana jest nazwa zasobu usuniętej oferty pakietowej w takim formacie:

customers/{customerId}/accountBudgetProposals/{account_budget_proposal_id} Prośba może zostać anulowana, jeśli jest oczekująca.

MutateAccountBudgetProposalResult

W wyniku zmiany propozycji budżetu konta.

Zapis JSON 
{
  "resourceName": string
}
Pola
resourceName

string

Zwracany w przypadku udanych operacji.