1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="localservices_v1.html">Local Services API</a> . <a href="localservices_v1.detailedLeadReports.html">detailedLeadReports</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#search">search(endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, query=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)</a></code></p>
<p class="firstline">Get detailed lead reports containing leads that have been received by all linked GLS accounts. Caller needs to provide their manager customer id and the associated auth credential that allows them read permissions on their linked accounts.</p>
<p class="toc_element">
<code><a href="#search_next">search_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="search">search(endDate_day=None, endDate_month=None, endDate_year=None, pageSize=None, pageToken=None, query=None, startDate_day=None, startDate_month=None, startDate_year=None, x__xgafv=None)</code>
<pre>Get detailed lead reports containing leads that have been received by all linked GLS accounts. Caller needs to provide their manager customer id and the associated auth credential that allows them read permissions on their linked accounts.
Args:
endDate_day: integer, Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
endDate_month: integer, Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
endDate_year: integer, Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
pageSize: integer, The maximum number of accounts to return. If the page size is unset, page size will default to 1000. Maximum page_size is 10000. Optional.
pageToken: string, The `next_page_token` value returned from a previous request to SearchDetailedLeadReports that indicates where listing should continue. Optional.
query: string, A query string for searching for account reports. Caller must provide a customer id of their MCC account with an associated Gaia Mint that allows read permission on their linked accounts. Search expressions are case insensitive. Example query: | Query | Description | |-------------------------|-----------------------------------------------| | manager_customer_id:123 | Get Detailed Lead Report for Manager with id | | | 123. | Required.
startDate_day: integer, Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
startDate_month: integer, Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
startDate_year: integer, Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A page of the response received from the SearchDetailedLeadReports method. A paginated response where more pages are available has `next_page_token` set. This token can be used in a subsequent request to retrieve the next request page.
"detailedLeadReports": [ # List of detailed lead reports uniquely identified by external lead id.
{ # A Detailed Lead Report of a lead identified by their lead id and contains consumer, account, monetization, and lead data.
"accountId": "A String", # Identifies account that received the lead.
"aggregatorInfo": { # Conatiner for aggregator specific information if lead is for an aggregator GLS account. # Aggregator specific information related to the lead.
"aggregatorProviderId": "A String", # Provider id (listed in aggregator system) which maps to a account id in GLS system.
},
"bookingLead": { # Container for booking lead specific information. # More information associated to only booking leads.
"bookingAppointmentTimestamp": "A String", # Timestamp of when service is provided by advertiser.
"consumerEmail": "A String", # Consumer email associated with the booking lead.
"consumerPhoneNumber": "A String", # Consumer phone number associated with the booking lead.
"customerName": "A String", # Name of the customer who created the lead.
"jobType": "A String", # The job type of the specified lead.
},
"businessName": "A String", # Business name associated to the account.
"chargeStatus": "A String", # Whether the lead has been charged.
"currencyCode": "A String", # Currency code.
"disputeStatus": "A String", # Dispute status related to the lead.
"geo": "A String", # Location of the associated account's home city.
"googleAdsLeadId": "A String", # Unique identifier of a Detailed Lead Report.
"leadCategory": "A String", # Lead category (e.g. hvac, plumber)
"leadCreationTimestamp": "A String", # Timestamp of when the lead was created.
"leadId": "A String", # Deprecated in favor of google_ads_lead_id. Unique identifier of a Detailed Lead Report.
"leadPrice": 3.14, # Price of the lead (available only after it has been charged).
"leadType": "A String", # Lead type.
"messageLead": { # Container for message lead specific information. # More information associated to only message leads.
"consumerPhoneNumber": "A String", # Consumer phone number associated with the message lead.
"customerName": "A String", # Name of the customer who created the lead.
"jobType": "A String", # The job type of the specified lead.
"postalCode": "A String", # The postal code of the customer who created the lead.
},
"phoneLead": { # Container for phone lead specific information. # More information associated to only phone leads.
"chargedCallTimestamp": "A String", # Timestamp of the phone call which resulted in a charged phone lead.
"chargedConnectedCallDurationSeconds": "A String", # Duration of the charged phone call in seconds.
"consumerPhoneNumber": "A String", # Consumer phone number associated with the phone lead.
},
"timezone": { # Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones). # Timezone of the particular provider associated to a lead.
"id": "A String", # IANA Time Zone Database time zone. For example "America/New_York".
"version": "A String", # Optional. IANA Time Zone Database version number. For example "2019a".
},
},
],
"nextPageToken": "A String", # Pagination token to retrieve the next page of results. When `next_page_token` is not filled in, there is no next page and the list returned is the last page in the result set.
}</pre>
</div>
<div class="method">
<code class="details" id="search_next">search_next()</code>
<pre>Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>
</body></html>
|
