docs/dyn/gan.v1beta1.advertisers.html - platform/external/python/google-api-python-client - Gitiles


 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html><head><title>Python: class Resource</title>
 </head><body bgcolor="#f0f0f8">
 <p>
 <table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
 <tr bgcolor="#ffc8d8">
 <td colspan=3 valign=bottom>&nbsp;<br>
 <font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>

 <tr bgcolor="#ffc8d8"><td rowspan=2><tt>&nbsp;&nbsp;&nbsp;</tt></td>
 <td colspan=2><tt>A&nbsp;class&nbsp;for&nbsp;interacting&nbsp;with&nbsp;a&nbsp;resource.<br>&nbsp;</tt></td></tr>
 <tr><td>&nbsp;</td>
 <td width="100%">Methods defined here:<br>
 <dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>

 <dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves&nbsp;data&nbsp;about&nbsp;a&nbsp;single&nbsp;advertiser&nbsp;if&nbsp;that&nbsp;the&nbsp;requesting&nbsp;advertiser/publisher&nbsp;has&nbsp;access&nbsp;to&nbsp;it.&nbsp;Only&nbsp;publishers&nbsp;can&nbsp;lookup&nbsp;advertisers.&nbsp;Advertisers&nbsp;can&nbsp;request&nbsp;information&nbsp;about&nbsp;themselves&nbsp;by&nbsp;omitting&nbsp;the&nbsp;advertiserId&nbsp;query&nbsp;parameter.<br>
 &nbsp;<br>
 Args:<br>
 &nbsp;&nbsp;advertiserId:&nbsp;string,&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;advertiser&nbsp;to&nbsp;look&nbsp;up.&nbsp;Optional.<br>
 &nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;roleId:&nbsp;string,&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;requesting&nbsp;advertiser&nbsp;or&nbsp;publisher.&nbsp;(required)<br>
 &nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;role:&nbsp;string,&nbsp;The&nbsp;role&nbsp;of&nbsp;the&nbsp;requester.&nbsp;Valid&nbsp;values:&nbsp;'advertisers'&nbsp;or&nbsp;'publishers'.&nbsp;(required)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;advertisers&nbsp;-&nbsp;The&nbsp;requester&nbsp;is&nbsp;requesting&nbsp;as&nbsp;an&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;publishers&nbsp;-&nbsp;The&nbsp;requester&nbsp;is&nbsp;requesting&nbsp;as&nbsp;a&nbsp;publisher.<br>
 &nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;<br>
 Returns:<br>
 &nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
 &nbsp;<br>
 &nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;#&nbsp;An&nbsp;AdvertiserResource.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"category":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Category&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;belongs&nbsp;to.&nbsp;A&nbsp;valid&nbsp;list&nbsp;of&nbsp;categories&nbsp;can&nbsp;be&nbsp;found&nbsp;here:&nbsp;<a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581</a><br>
 &nbsp;&nbsp;&nbsp;&nbsp;"contactEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Email&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;would&nbsp;like&nbsp;publishers&nbsp;to&nbsp;contact&nbsp;them&nbsp;with.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"gan#advertiser",&nbsp;#&nbsp;The&nbsp;kind&nbsp;for&nbsp;an&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"siteUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;of&nbsp;the&nbsp;website&nbsp;this&nbsp;advertiser&nbsp;advertises&nbsp;from.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"contactPhone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Phone&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;would&nbsp;like&nbsp;publishers&nbsp;to&nbsp;contact&nbsp;them&nbsp;with.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;website&nbsp;the&nbsp;advertiser&nbsp;advertises&nbsp;from.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"payoutRank":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;rank&nbsp;based&nbsp;on&nbsp;commissions&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;over&nbsp;the&nbsp;past&nbsp;90&nbsp;days.&nbsp;A&nbsp;number&nbsp;between&nbsp;1&nbsp;and&nbsp;4&nbsp;where&nbsp;4&nbsp;means&nbsp;the&nbsp;top&nbsp;quartile&nbsp;(most&nbsp;money&nbsp;paid)&nbsp;and&nbsp;1&nbsp;means&nbsp;the&nbsp;bottom&nbsp;quartile&nbsp;(least&nbsp;money&nbsp;paid).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"epcSevenDayAverage":&nbsp;{&nbsp;#&nbsp;An&nbsp;ApiMoneyProto.&nbsp;#&nbsp;The&nbsp;sum&nbsp;of&nbsp;fees&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;divided&nbsp;by&nbsp;the&nbsp;total&nbsp;number&nbsp;of&nbsp;clicks&nbsp;over&nbsp;the&nbsp;past&nbsp;seven&nbsp;days.&nbsp;Values&nbsp;are&nbsp;multiplied&nbsp;by&nbsp;100&nbsp;for&nbsp;display&nbsp;purposes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;The&nbsp;amount&nbsp;of&nbsp;money.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;3-letter&nbsp;code&nbsp;of&nbsp;the&nbsp;currency&nbsp;in&nbsp;question.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"commissionDuration":&nbsp;42,&nbsp;#&nbsp;The&nbsp;longest&nbsp;possible&nbsp;length&nbsp;of&nbsp;a&nbsp;commission&nbsp;(how&nbsp;long&nbsp;the&nbsp;cookies&nbsp;on&nbsp;the&nbsp;customer's&nbsp;browser&nbsp;last&nbsp;before&nbsp;they&nbsp;expire).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;status&nbsp;of&nbsp;the&nbsp;requesting&nbsp;publisher's&nbsp;relationship&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"epcNinetyDayAverage":&nbsp;{&nbsp;#&nbsp;An&nbsp;ApiMoneyProto.&nbsp;#&nbsp;The&nbsp;sum&nbsp;of&nbsp;fees&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;divided&nbsp;by&nbsp;the&nbsp;total&nbsp;number&nbsp;of&nbsp;clicks&nbsp;over&nbsp;the&nbsp;past&nbsp;three&nbsp;months.&nbsp;Values&nbsp;are&nbsp;multiplied&nbsp;by&nbsp;100&nbsp;for&nbsp;display&nbsp;purposes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;The&nbsp;amount&nbsp;of&nbsp;money.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;3-letter&nbsp;code&nbsp;of&nbsp;the&nbsp;currency&nbsp;in&nbsp;question.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"allowPublisherCreatedLinks":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;True&nbsp;if&nbsp;the&nbsp;advertiser&nbsp;allows&nbsp;publisher&nbsp;created&nbsp;links,&nbsp;otherwise&nbsp;false.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"item":&nbsp;#&nbsp;Object&nbsp;with&nbsp;schema&nbsp;name:&nbsp;Advertiser&nbsp;#&nbsp;The&nbsp;requested&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"joinDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Date&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;was&nbsp;approved&nbsp;as&nbsp;a&nbsp;Google&nbsp;Affiliate&nbsp;Network&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"logoUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;the&nbsp;logo&nbsp;this&nbsp;advertiser&nbsp;uses&nbsp;on&nbsp;the&nbsp;Google&nbsp;Affiliate&nbsp;Network.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;ID&nbsp;of&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"productFeedsEnabled":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Allows&nbsp;advertisers&nbsp;to&nbsp;submit&nbsp;product&nbsp;listings&nbsp;to&nbsp;Google&nbsp;Product&nbsp;Search.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"name":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;}</tt></dd></dl>

 <dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves&nbsp;data&nbsp;about&nbsp;all&nbsp;advertisers&nbsp;that&nbsp;the&nbsp;requesting&nbsp;advertiser/publisher&nbsp;has&nbsp;access&nbsp;to.<br>
 &nbsp;<br>
 Args:<br>
 &nbsp;&nbsp;relationshipStatus:&nbsp;string,&nbsp;Filters&nbsp;out&nbsp;all&nbsp;advertisers&nbsp;for&nbsp;which&nbsp;do&nbsp;not&nbsp;have&nbsp;the&nbsp;given&nbsp;relationship&nbsp;status&nbsp;with&nbsp;the&nbsp;requesting&nbsp;publisher.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;approved&nbsp;-&nbsp;An&nbsp;advertiser&nbsp;that&nbsp;has&nbsp;approved&nbsp;your&nbsp;application.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;available&nbsp;-&nbsp;An&nbsp;advertiser&nbsp;program&nbsp;that's&nbsp;accepting&nbsp;new&nbsp;publishers.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;deactivated&nbsp;-&nbsp;Deactivated&nbsp;means&nbsp;either&nbsp;the&nbsp;advertiser&nbsp;has&nbsp;removed&nbsp;you&nbsp;from&nbsp;their&nbsp;program,&nbsp;or&nbsp;it&nbsp;could&nbsp;also&nbsp;mean&nbsp;that&nbsp;you&nbsp;chose&nbsp;to&nbsp;remove&nbsp;yourself&nbsp;from&nbsp;the&nbsp;advertiser's&nbsp;program.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;declined&nbsp;-&nbsp;An&nbsp;advertiser&nbsp;that&nbsp;did&nbsp;not&nbsp;approve&nbsp;your&nbsp;application.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pending&nbsp;-&nbsp;An&nbsp;advertiser&nbsp;program&nbsp;that&nbsp;you've&nbsp;already&nbsp;applied&nbsp;to,&nbsp;but&nbsp;they&nbsp;haven't&nbsp;yet&nbsp;decided&nbsp;to&nbsp;approve&nbsp;or&nbsp;decline&nbsp;your&nbsp;application.<br>
 &nbsp;&nbsp;trace:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;pageToken:&nbsp;string,&nbsp;The&nbsp;value&nbsp;of&nbsp;'nextPageToken'&nbsp;from&nbsp;the&nbsp;previous&nbsp;page.&nbsp;Optional.<br>
 &nbsp;&nbsp;pp:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;roleId:&nbsp;string,&nbsp;The&nbsp;ID&nbsp;of&nbsp;the&nbsp;requesting&nbsp;advertiser&nbsp;or&nbsp;publisher.&nbsp;(required)<br>
 &nbsp;&nbsp;advertiserCategory:&nbsp;string,&nbsp;Caret(^)&nbsp;delimted&nbsp;list&nbsp;of&nbsp;advertiser&nbsp;categories.&nbsp;Valid&nbsp;categories&nbsp;are&nbsp;defined&nbsp;here:&nbsp;<a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581</a>.&nbsp;Filters&nbsp;out&nbsp;all&nbsp;advertisers&nbsp;not&nbsp;in&nbsp;one&nbsp;of&nbsp;the&nbsp;given&nbsp;advertiser&nbsp;categories.&nbsp;Optional.<br>
 &nbsp;&nbsp;minNinetyDayEpc:&nbsp;number,&nbsp;Filters&nbsp;out&nbsp;all&nbsp;advertisers&nbsp;that&nbsp;have&nbsp;a&nbsp;ninety&nbsp;day&nbsp;EPC&nbsp;average&nbsp;lower&nbsp;than&nbsp;the&nbsp;given&nbsp;value&nbsp;(inclusive).&nbsp;Min&nbsp;value:&nbsp;0.0.&nbsp;Optional.<br>
 &nbsp;&nbsp;strict:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;role:&nbsp;string,&nbsp;The&nbsp;role&nbsp;of&nbsp;the&nbsp;requester.&nbsp;Valid&nbsp;values:&nbsp;'advertisers'&nbsp;or&nbsp;'publishers'.&nbsp;(required)<br>
 &nbsp;&nbsp;&nbsp;&nbsp;Allowed&nbsp;values<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;advertisers&nbsp;-&nbsp;The&nbsp;requester&nbsp;is&nbsp;requesting&nbsp;as&nbsp;an&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;publishers&nbsp;-&nbsp;The&nbsp;requester&nbsp;is&nbsp;requesting&nbsp;as&nbsp;a&nbsp;publisher.<br>
 &nbsp;&nbsp;maxResults:&nbsp;integer,&nbsp;Max&nbsp;number&nbsp;of&nbsp;items&nbsp;to&nbsp;return&nbsp;in&nbsp;this&nbsp;page.&nbsp;Optional.&nbsp;Defaults&nbsp;to&nbsp;20.<br>
 &nbsp;&nbsp;minSevenDayEpc:&nbsp;number,&nbsp;Filters&nbsp;out&nbsp;all&nbsp;advertisers&nbsp;that&nbsp;have&nbsp;a&nbsp;seven&nbsp;day&nbsp;EPC&nbsp;average&nbsp;lower&nbsp;than&nbsp;the&nbsp;given&nbsp;value&nbsp;(inclusive).&nbsp;Min&nbsp;value:&nbsp;0.0.&nbsp;Optional.<br>
 &nbsp;&nbsp;userip:&nbsp;string,&nbsp;A&nbsp;parameter<br>
 &nbsp;&nbsp;minPayoutRank:&nbsp;integer,&nbsp;A&nbsp;value&nbsp;between&nbsp;1&nbsp;and&nbsp;4,&nbsp;where&nbsp;1&nbsp;represents&nbsp;the&nbsp;quartile&nbsp;of&nbsp;advertisers&nbsp;with&nbsp;the&nbsp;lowest&nbsp;ranks&nbsp;and&nbsp;4&nbsp;represents&nbsp;the&nbsp;quartile&nbsp;of&nbsp;advertisers&nbsp;with&nbsp;the&nbsp;highest&nbsp;ranks.&nbsp;Filters&nbsp;out&nbsp;all&nbsp;advertisers&nbsp;with&nbsp;a&nbsp;lower&nbsp;rank&nbsp;than&nbsp;the&nbsp;given&nbsp;quartile.&nbsp;For&nbsp;example&nbsp;if&nbsp;a&nbsp;2&nbsp;was&nbsp;given&nbsp;only&nbsp;advertisers&nbsp;with&nbsp;a&nbsp;payout&nbsp;rank&nbsp;of&nbsp;25&nbsp;or&nbsp;higher&nbsp;would&nbsp;be&nbsp;included.&nbsp;Optional.<br>
 &nbsp;<br>
 Returns:<br>
 &nbsp;&nbsp;An&nbsp;object&nbsp;of&nbsp;the&nbsp;form<br>
 &nbsp;<br>
 &nbsp;&nbsp;&nbsp;&nbsp;{<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"nextPageToken":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;'pageToken'&nbsp;to&nbsp;pass&nbsp;to&nbsp;the&nbsp;next&nbsp;request&nbsp;to&nbsp;get&nbsp;the&nbsp;next&nbsp;page,&nbsp;if&nbsp;there&nbsp;are&nbsp;more&nbsp;to&nbsp;retrieve.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"items":&nbsp;[&nbsp;#&nbsp;The&nbsp;advertiser&nbsp;list.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{&nbsp;#&nbsp;An&nbsp;AdvertiserResource.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"category":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Category&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;belongs&nbsp;to.&nbsp;A&nbsp;valid&nbsp;list&nbsp;of&nbsp;categories&nbsp;can&nbsp;be&nbsp;found&nbsp;here:&nbsp;<a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&amp;answer=107581</a><br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"contactEmail":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Email&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;would&nbsp;like&nbsp;publishers&nbsp;to&nbsp;contact&nbsp;them&nbsp;with.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"gan#advertiser",&nbsp;#&nbsp;The&nbsp;kind&nbsp;for&nbsp;an&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"siteUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;of&nbsp;the&nbsp;website&nbsp;this&nbsp;advertiser&nbsp;advertises&nbsp;from.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"contactPhone":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Phone&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;would&nbsp;like&nbsp;publishers&nbsp;to&nbsp;contact&nbsp;them&nbsp;with.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"description":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Description&nbsp;of&nbsp;the&nbsp;website&nbsp;the&nbsp;advertiser&nbsp;advertises&nbsp;from.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"payoutRank":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;A&nbsp;rank&nbsp;based&nbsp;on&nbsp;commissions&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;over&nbsp;the&nbsp;past&nbsp;90&nbsp;days.&nbsp;A&nbsp;number&nbsp;between&nbsp;1&nbsp;and&nbsp;4&nbsp;where&nbsp;4&nbsp;means&nbsp;the&nbsp;top&nbsp;quartile&nbsp;(most&nbsp;money&nbsp;paid)&nbsp;and&nbsp;1&nbsp;means&nbsp;the&nbsp;bottom&nbsp;quartile&nbsp;(least&nbsp;money&nbsp;paid).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"epcSevenDayAverage":&nbsp;{&nbsp;#&nbsp;An&nbsp;ApiMoneyProto.&nbsp;#&nbsp;The&nbsp;sum&nbsp;of&nbsp;fees&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;divided&nbsp;by&nbsp;the&nbsp;total&nbsp;number&nbsp;of&nbsp;clicks&nbsp;over&nbsp;the&nbsp;past&nbsp;seven&nbsp;days.&nbsp;Values&nbsp;are&nbsp;multiplied&nbsp;by&nbsp;100&nbsp;for&nbsp;display&nbsp;purposes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;The&nbsp;amount&nbsp;of&nbsp;money.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;3-letter&nbsp;code&nbsp;of&nbsp;the&nbsp;currency&nbsp;in&nbsp;question.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"commissionDuration":&nbsp;42,&nbsp;#&nbsp;The&nbsp;longest&nbsp;possible&nbsp;length&nbsp;of&nbsp;a&nbsp;commission&nbsp;(how&nbsp;long&nbsp;the&nbsp;cookies&nbsp;on&nbsp;the&nbsp;customer's&nbsp;browser&nbsp;last&nbsp;before&nbsp;they&nbsp;expire).<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"status":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;status&nbsp;of&nbsp;the&nbsp;requesting&nbsp;publisher's&nbsp;relationship&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"epcNinetyDayAverage":&nbsp;{&nbsp;#&nbsp;An&nbsp;ApiMoneyProto.&nbsp;#&nbsp;The&nbsp;sum&nbsp;of&nbsp;fees&nbsp;paid&nbsp;to&nbsp;publishers&nbsp;divided&nbsp;by&nbsp;the&nbsp;total&nbsp;number&nbsp;of&nbsp;clicks&nbsp;over&nbsp;the&nbsp;past&nbsp;three&nbsp;months.&nbsp;Values&nbsp;are&nbsp;multiplied&nbsp;by&nbsp;100&nbsp;for&nbsp;display&nbsp;purposes.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"amount":&nbsp;3.14,&nbsp;#&nbsp;The&nbsp;amount&nbsp;of&nbsp;money.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"currencyCode":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;3-letter&nbsp;code&nbsp;of&nbsp;the&nbsp;currency&nbsp;in&nbsp;question.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"allowPublisherCreatedLinks":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;True&nbsp;if&nbsp;the&nbsp;advertiser&nbsp;allows&nbsp;publisher&nbsp;created&nbsp;links,&nbsp;otherwise&nbsp;false.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"item":&nbsp;#&nbsp;Object&nbsp;with&nbsp;schema&nbsp;name:&nbsp;Advertiser&nbsp;#&nbsp;The&nbsp;requested&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"joinDate":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;Date&nbsp;that&nbsp;this&nbsp;advertiser&nbsp;was&nbsp;approved&nbsp;as&nbsp;a&nbsp;Google&nbsp;Affiliate&nbsp;Network&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"logoUrl":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;URL&nbsp;to&nbsp;the&nbsp;logo&nbsp;this&nbsp;advertiser&nbsp;uses&nbsp;on&nbsp;the&nbsp;Google&nbsp;Affiliate&nbsp;Network.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"id":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;ID&nbsp;of&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"productFeedsEnabled":&nbsp;True&nbsp;or&nbsp;False,&nbsp;#&nbsp;Allows&nbsp;advertisers&nbsp;to&nbsp;submit&nbsp;product&nbsp;listings&nbsp;to&nbsp;Google&nbsp;Product&nbsp;Search.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name":&nbsp;"A&nbsp;String",&nbsp;#&nbsp;The&nbsp;name&nbsp;of&nbsp;this&nbsp;advertiser.<br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;},<br>
 &nbsp;&nbsp;&nbsp;&nbsp;],<br>
 &nbsp;&nbsp;&nbsp;&nbsp;"kind":&nbsp;"gan#advertisers",&nbsp;#&nbsp;The&nbsp;kind&nbsp;for&nbsp;a&nbsp;page&nbsp;of&nbsp;advertisers.<br>
 &nbsp;&nbsp;}</tt></dd></dl>

 <dl><dt><a name="Resource-list_next"><strong>list_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves&nbsp;the&nbsp;next&nbsp;page&nbsp;of&nbsp;results.<br>
 &nbsp;<br>
 Args:<br>
 &nbsp;&nbsp;previous_request:&nbsp;The&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
 &nbsp;&nbsp;previous_response:&nbsp;The&nbsp;response&nbsp;from&nbsp;the&nbsp;request&nbsp;for&nbsp;the&nbsp;previous&nbsp;page.<br>
 &nbsp;<br>
 Returns:<br>
 &nbsp;&nbsp;A&nbsp;request&nbsp;object&nbsp;that&nbsp;you&nbsp;can&nbsp;call&nbsp;'execute()'&nbsp;on&nbsp;to&nbsp;request&nbsp;the&nbsp;next<br>
 &nbsp;&nbsp;page.&nbsp;Returns&nbsp;None&nbsp;if&nbsp;there&nbsp;are&nbsp;no&nbsp;more&nbsp;items&nbsp;in&nbsp;the&nbsp;collection.</tt></dd></dl>

 <hr>
 Data descriptors defined here:<br>
 <dl><dt><strong>__dict__</strong></dt>
 <dd><tt>dictionary&nbsp;for&nbsp;instance&nbsp;variables&nbsp;(if&nbsp;defined)</tt></dd>
 </dl>
 <dl><dt><strong>__weakref__</strong></dt>
 <dd><tt>list&nbsp;of&nbsp;weak&nbsp;references&nbsp;to&nbsp;the&nbsp;object&nbsp;(if&nbsp;defined)</tt></dd>
 </dl>
 </td></tr></table>
 </body></html>

	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	<html><head><title>Python: class Resource</title>
	</head><body bgcolor="#f0f0f8">
	<p>
	<table width="100%" cellspacing=0 cellpadding=2 border=0 summary="section">
	<tr bgcolor="#ffc8d8">
	<td colspan=3 valign=bottom> <br>
	<font color="#000000" face="helvetica, arial"><a name="Resource">class <strong>Resource</strong></a>(<a href="__builtin__.html#object">__builtin__.object</a>)</font></td></tr>

	<tr bgcolor="#ffc8d8"><td rowspan=2><tt>   </tt></td>
	<td colspan=2><tt>A class for interacting with a resource.<br> </tt></td></tr>
	<tr><td> </td>
	<td width="100%">Methods defined here:<br>
	<dl><dt><a name="Resource-__init__"><strong>__init__</strong></a>(self)</dt></dl>

	<dl><dt><a name="Resource-get"><strong>get</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves data about a single advertiser if that the requesting advertiser/publisher has access to it. Only publishers can lookup advertisers. Advertisers can request information about themselves by omitting the advertiserId query parameter.<br>
	<br>
	Args:<br>
	advertiserId: string, The ID of the advertiser to look up. Optional.<br>
	pp: string, A parameter<br>
	trace: string, A parameter<br>
	roleId: string, The ID of the requesting advertiser or publisher. (required)<br>
	strict: string, A parameter<br>
	role: string, The role of the requester. Valid values: 'advertisers' or 'publishers'. (required)<br>
	Allowed values<br>
	advertisers - The requester is requesting as an advertiser.<br>
	publishers - The requester is requesting as a publisher.<br>
	userip: string, A parameter<br>
	<br>
	Returns:<br>
	An object of the form<br>
	<br>
	{ # An AdvertiserResource.<br>
	"category": "A String", # Category that this advertiser belongs to. A valid list of categories can be found here: <a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581</a><br>
	"contactEmail": "A String", # Email that this advertiser would like publishers to contact them with.<br>
	"kind": "gan#advertiser", # The kind for an advertiser.<br>
	"siteUrl": "A String", # URL of the website this advertiser advertises from.<br>
	"contactPhone": "A String", # Phone that this advertiser would like publishers to contact them with.<br>
	"description": "A String", # Description of the website the advertiser advertises from.<br>
	"payoutRank": "A String", # A rank based on commissions paid to publishers over the past 90 days. A number between 1 and 4 where 4 means the top quartile (most money paid) and 1 means the bottom quartile (least money paid).<br>
	"epcSevenDayAverage": { # An ApiMoneyProto. # The sum of fees paid to publishers divided by the total number of clicks over the past seven days. Values are multiplied by 100 for display purposes.<br>
	"amount": 3.14, # The amount of money.<br>
	"currencyCode": "A String", # The 3-letter code of the currency in question.<br>
	},<br>
	"commissionDuration": 42, # The longest possible length of a commission (how long the cookies on the customer's browser last before they expire).<br>
	"status": "A String", # The status of the requesting publisher's relationship this advertiser.<br>
	"epcNinetyDayAverage": { # An ApiMoneyProto. # The sum of fees paid to publishers divided by the total number of clicks over the past three months. Values are multiplied by 100 for display purposes.<br>
	"amount": 3.14, # The amount of money.<br>
	"currencyCode": "A String", # The 3-letter code of the currency in question.<br>
	},<br>
	"allowPublisherCreatedLinks": True or False, # True if the advertiser allows publisher created links, otherwise false.<br>
	"item": # Object with schema name: Advertiser # The requested advertiser.<br>
	"joinDate": "A String", # Date that this advertiser was approved as a Google Affiliate Network advertiser.<br>
	"logoUrl": "A String", # URL to the logo this advertiser uses on the Google Affiliate Network.<br>
	"id": "A String", # The ID of this advertiser.<br>
	"productFeedsEnabled": True or False, # Allows advertisers to submit product listings to Google Product Search.<br>
	"name": "A String", # The name of this advertiser.<br>
	}</tt></dd></dl>

	<dl><dt><a name="Resource-list"><strong>list</strong></a> = method(self, **kwargs)</dt><dd><tt>Retrieves data about all advertisers that the requesting advertiser/publisher has access to.<br>
	<br>
	Args:<br>
	relationshipStatus: string, Filters out all advertisers for which do not have the given relationship status with the requesting publisher.<br>
	Allowed values<br>
	approved - An advertiser that has approved your application.<br>
	available - An advertiser program that's accepting new publishers.<br>
	deactivated - Deactivated means either the advertiser has removed you from their program, or it could also mean that you chose to remove yourself from the advertiser's program.<br>
	declined - An advertiser that did not approve your application.<br>
	pending - An advertiser program that you've already applied to, but they haven't yet decided to approve or decline your application.<br>
	trace: string, A parameter<br>
	pageToken: string, The value of 'nextPageToken' from the previous page. Optional.<br>
	pp: string, A parameter<br>
	roleId: string, The ID of the requesting advertiser or publisher. (required)<br>
	advertiserCategory: string, Caret(^) delimted list of advertiser categories. Valid categories are defined here: <a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581</a>. Filters out all advertisers not in one of the given advertiser categories. Optional.<br>
	minNinetyDayEpc: number, Filters out all advertisers that have a ninety day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.<br>
	strict: string, A parameter<br>
	role: string, The role of the requester. Valid values: 'advertisers' or 'publishers'. (required)<br>
	Allowed values<br>
	advertisers - The requester is requesting as an advertiser.<br>
	publishers - The requester is requesting as a publisher.<br>
	maxResults: integer, Max number of items to return in this page. Optional. Defaults to 20.<br>
	minSevenDayEpc: number, Filters out all advertisers that have a seven day EPC average lower than the given value (inclusive). Min value: 0.0. Optional.<br>
	userip: string, A parameter<br>
	minPayoutRank: integer, A value between 1 and 4, where 1 represents the quartile of advertisers with the lowest ranks and 4 represents the quartile of advertisers with the highest ranks. Filters out all advertisers with a lower rank than the given quartile. For example if a 2 was given only advertisers with a payout rank of 25 or higher would be included. Optional.<br>
	<br>
	Returns:<br>
	An object of the form<br>
	<br>
	{<br>
	"nextPageToken": "A String", # The 'pageToken' to pass to the next request to get the next page, if there are more to retrieve.<br>
	"items": [ # The advertiser list.<br>
	{ # An AdvertiserResource.<br>
	"category": "A String", # Category that this advertiser belongs to. A valid list of categories can be found here: <a href="http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581">http://www.google.com/support/affiliatenetwork/advertiser/bin/answer.py?hl=en&answer=107581</a><br>
	"contactEmail": "A String", # Email that this advertiser would like publishers to contact them with.<br>
	"kind": "gan#advertiser", # The kind for an advertiser.<br>
	"siteUrl": "A String", # URL of the website this advertiser advertises from.<br>
	"contactPhone": "A String", # Phone that this advertiser would like publishers to contact them with.<br>
	"description": "A String", # Description of the website the advertiser advertises from.<br>
	"payoutRank": "A String", # A rank based on commissions paid to publishers over the past 90 days. A number between 1 and 4 where 4 means the top quartile (most money paid) and 1 means the bottom quartile (least money paid).<br>
	"epcSevenDayAverage": { # An ApiMoneyProto. # The sum of fees paid to publishers divided by the total number of clicks over the past seven days. Values are multiplied by 100 for display purposes.<br>
	"amount": 3.14, # The amount of money.<br>
	"currencyCode": "A String", # The 3-letter code of the currency in question.<br>
	},<br>
	"commissionDuration": 42, # The longest possible length of a commission (how long the cookies on the customer's browser last before they expire).<br>
	"status": "A String", # The status of the requesting publisher's relationship this advertiser.<br>
	"epcNinetyDayAverage": { # An ApiMoneyProto. # The sum of fees paid to publishers divided by the total number of clicks over the past three months. Values are multiplied by 100 for display purposes.<br>
	"amount": 3.14, # The amount of money.<br>
	"currencyCode": "A String", # The 3-letter code of the currency in question.<br>
	},<br>
	"allowPublisherCreatedLinks": True or False, # True if the advertiser allows publisher created links, otherwise false.<br>
	"item": # Object with schema name: Advertiser # The requested advertiser.<br>
	"joinDate": "A String", # Date that this advertiser was approved as a Google Affiliate Network advertiser.<br>
	"logoUrl": "A String", # URL to the logo this advertiser uses on the Google Affiliate Network.<br>
	"id": "A String", # The ID of this advertiser.<br>
	"productFeedsEnabled": True or False, # Allows advertisers to submit product listings to Google Product Search.<br>
	"name": "A String", # The name of this advertiser.<br>
	},<br>
	],<br>
	"kind": "gan#advertisers", # The kind for a page of advertisers.<br>
	}</tt></dd></dl>

	<dl><dt><a name="Resource-list_next"><strong>list_next</strong></a> = methodNext(self, previous_request, previous_response)</dt><dd><tt>Retrieves the next page of results.<br>
	<br>
	Args:<br>
	previous_request: The request for the previous page.<br>
	previous_response: The response from the request for the previous page.<br>
	<br>
	Returns:<br>
	A request object that you can call 'execute()' on to request the next<br>
	page. Returns None if there are no more items in the collection.</tt></dd></dl>

	<hr>
	Data descriptors defined here:<br>
	<dl><dt><strong>__dict__</strong></dt>
	<dd><tt>dictionary for instance variables (if defined)</tt></dd>
	</dl>
	<dl><dt><strong>__weakref__</strong></dt>
	<dd><tt>list of weak references to the object (if defined)</tt></dd>
	</dl>
	</td></tr></table>
	</body></html>