Google Partners API . companies . leads

Instance Methods

create(companyId, body, x__xgafv=None)

Creates an advertiser lead for the given company ID.

Method Details

create(companyId, body, x__xgafv=None)
Creates an advertiser lead for the given company ID.

Args:
  companyId: string, The ID of the company to contact. (required)
  body: object, The request body. (required)
    The object takes the form of:

{ # Request message for CreateLead.
    "requestMetadata": { # Common data that is in each API request. # Current request metadata.
      "locale": "A String", # Locale to use for the current request.
      "partnersSessionId": "A String", # Google Partners session ID.
      "trafficSource": { # Source of traffic for the current request. # Source of traffic for the current request.
        "trafficSubId": "A String", # Second level identifier to indicate where the traffic comes from.
            # An identifier has multiple letters created by a team which redirected the
            # traffic to us.
        "trafficSourceId": "A String", # Identifier to indicate where the traffic comes from.
            # An identifier has multiple letters created by a team which redirected the
            # traffic to us.
      },
      "userOverrides": { # Values to use instead of the user's respective defaults. These are only # Values to use instead of the user's respective defaults for the current
          # request. These are only honored by whitelisted products.
          # honored by whitelisted products.
        "userId": "A String", # Logged-in user ID to impersonate instead of the user's ID.
        "ipAddress": "A String", # IP address to use instead of the user's geo-located IP address.
      },
      "experimentIds": [ # Experiment IDs the current request belongs to.
        "A String",
      ],
    },
    "recaptchaChallenge": { # reCaptcha challenge info. # reCaptcha challenge info.
      "id": "A String", # The ID of the reCaptcha challenge.
      "response": "A String", # The response to the reCaptcha challenge.
    },
    "lead": { # A lead resource that represents an advertiser contact for a `Company`. These # The lead resource. The `LeadType` must not be `LEAD_TYPE_UNSPECIFIED`
        # and either `email` or `phone_number` must be provided.
        # are usually generated via Google Partner Search (the advertiser portal).
      "marketingOptIn": True or False, # Whether or not the lead signed up for marketing emails
      "languageCode": "A String", # Language code of the lead's language preference, as defined by
          # BCP 47
          # (IETF BCP 47, "Tags for Identifying Languages").
      "type": "A String", # Type of lead.
      "familyName": "A String", # Last name of lead source.
      "minMonthlyBudget": { # Represents an amount of money with its currency type. # The minimum monthly budget lead source is willing to spend.
        "nanos": 42, # 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.
        "units": "A String", # The whole units of the amount.
            # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
        "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
      },
      "comments": "A String", # Comments lead source gave.
      "createTime": "A String", # Timestamp of when this lead was created.
      "websiteUrl": "A String", # Website URL of lead source.
      "email": "A String", # Email address of lead source.
      "state": "A String", # The lead's state in relation to the company.
      "phoneNumber": "A String", # Phone number of lead source.
      "gpsMotivations": [ # List of reasons for using Google Partner Search and creating a lead.
        "A String",
      ],
      "givenName": "A String", # First name of lead source.
      "adwordsCustomerId": "A String", # The AdWords Customer ID of the lead.
      "id": "A String", # ID of the lead.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for CreateLead.
    "recaptchaStatus": "A String", # The outcome of reCaptcha
        # validation.
    "lead": { # A lead resource that represents an advertiser contact for a `Company`. These # Lead that was created depending on the outcome of
        # reCaptcha validation.
        # are usually generated via Google Partner Search (the advertiser portal).
      "marketingOptIn": True or False, # Whether or not the lead signed up for marketing emails
      "languageCode": "A String", # Language code of the lead's language preference, as defined by
          # BCP 47
          # (IETF BCP 47, "Tags for Identifying Languages").
      "type": "A String", # Type of lead.
      "familyName": "A String", # Last name of lead source.
      "minMonthlyBudget": { # Represents an amount of money with its currency type. # The minimum monthly budget lead source is willing to spend.
        "nanos": 42, # 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.
        "units": "A String", # The whole units of the amount.
            # For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
        "currencyCode": "A String", # The 3-letter currency code defined in ISO 4217.
      },
      "comments": "A String", # Comments lead source gave.
      "createTime": "A String", # Timestamp of when this lead was created.
      "websiteUrl": "A String", # Website URL of lead source.
      "email": "A String", # Email address of lead source.
      "state": "A String", # The lead's state in relation to the company.
      "phoneNumber": "A String", # Phone number of lead source.
      "gpsMotivations": [ # List of reasons for using Google Partner Search and creating a lead.
        "A String",
      ],
      "givenName": "A String", # First name of lead source.
      "adwordsCustomerId": "A String", # The AdWords Customer ID of the lead.
      "id": "A String", # ID of the lead.
    },
    "responseMetadata": { # Common data that is in each API response. # Current response metadata.
      "debugInfo": { # Debug information about this request. # Debug information about this request.
        "serverTraceInfo": "A String", # Server-side debug stack trace.
        "serviceUrl": "A String", # URL of the service that handled this request.
        "serverInfo": "A String", # Info about the server that serviced this request.
      },
    },
  }