Get global bid preferences for an Account
GET/v1/accounts/:accountId/global-preferences
Get global bid preferences for an Account
Request
Path Parameters
The Account identifier to get global preferences for.
Responses
- 200
- default
OK
- application/json
- Schema
- Example (from schema)
Schema
bidPreference
object
required
Preferences for when to bid and limits on bidding.
Whether bids should be placed on Mondays.
Whether bids should be placed on Tuesdays.
Whether bids should be placed on Wednesdays.
Whether bids should be placed on Thursdays.
Whether bids should be placed on Fridays.
Whether bids should be placed on Saturdays.
Whether bids should be placed on Sundays.
bidTimeFrom
object
Represents a time of day. The date and time zone are not significant
Hours of day in 24 hour format. Must be from 0 to 23
Minutes of hour of day. Must be from 0 to 59.
Seconds of minutes of the time. Must be from 0 to 59
Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
bidTimeTo
object
Represents a time of day. The date and time zone are not significant
Hours of day in 24 hour format. Must be from 0 to 23
Minutes of hour of day. Must be from 0 to 59.
Seconds of minutes of the time. Must be from 0 to 59
Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
(Optional) A limit for the number of bids that can be placed daily.
dailySpendLimit
object
Represents an amount of money with its currency type.
The whole units of the amount.
For example if currencyCode
is "USD"
, then 1 unit is one US dollar.
Number of nano (10^-9) units of the amount.
The value must be between -999,999,999 and +999,999,999 inclusive.
If units
is positive, nanos
must be positive or zero.
If units
is zero, nanos
can be positive, zero, or negative.
If units
is negative, nanos
must be negative or zero.
For example $-1.75 is represented as units
=-1 and nanos
=-750,000,000.
{
"bidPreference": {
"bidOnMonday": true,
"bidOnTuesday": true,
"bidOnWednesday": true,
"bidOnThursday": true,
"bidOnFriday": true,
"bidOnSaturday": true,
"bidOnSunday": true,
"bidTimeFrom": {
"hours": 0,
"minutes": 0,
"seconds": 0,
"nanos": 0
},
"bidTimeTo": {
"hours": 0,
"minutes": 0,
"seconds": 0,
"nanos": 0
},
"dailyLimit": 0,
"dailySpendLimit": {
"currencyCode": "string",
"units": "string",
"nanos": 0
}
}
}
Error
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
An error status code describing the response.
Enum Value | Description |
---|---|
0 | OK |
1 | Cancelled |
2 | Unknown |
3 | InvalidArgument |
4 | DeadlineExceeded |
5 | NotFound |
6 | AlreadyExists |
7 | PermissionDenied |
8 | ResourceExhausted |
9 | FailedPrecondition |
10 | Aborted |
11 | OutOfRange |
12 | Unimplemented |
13 | Internal |
14 | Unavailable |
15 | DataLoss |
16 | Unauthenticated |
Possible values: [0
, 1
, 2
, 3
, 4
, 5
, 6
, 7
, 8
, 9
, 10
, 11
, 12
, 13
, 14
, 15
, 16
]
A developer-facing error message
details
object[]
A list of messages containing details about the errors
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}