REST Resource: partners.leads

المورد: عميل محتمل

مورد يمثّل عميلاً محتملاً لأحد شركاء Google Cloud

تمثيل JSON
{
  "name": string,
  "engagementModel": enum (EngagementModel),
  "dealTransactionType": enum (DealTransactionType),
  "customer": {
    object (Customer)
  },
  "partnerAnnualContractValue": number,
  "leadCurrencyCode": string,
  "estimatedCloseDate": {
    object (Date)
  },
  "dealTerm": string,
  "opportunitySummary": string,
  "supportLevel": enum (SupportLevel),
  "productInterests": [
    enum (ProductFamily)
  ],
  "leadStatus": enum (State),
  "leadApprovalStatus": enum (ApprovalState),
  "submitterEmail": string,
  "submittedTime": string,
  "rejectionComments": string,
  "approvalNotes": string,
  "externalSystemId": string,
  "description": string,
  "title": string,
  "customerContactRequested": boolean,
  "deliveryModel": enum (DeliveryModel),
  "contractVehicle": enum (ContractVehicle),
  "isvSolutionConnectDeal": boolean,
  "rejectionReason": enum (RejectionReason),
  "leadSource": enum (LeadSource),
  "createDate": {
    object (Date)
  },
  "budget": enum (Budget),
  "timeline": enum (Timeline),
  "authority": enum (Authority),
  "need": enum (Need),
  "isPublicTender": boolean,
  "isConfidential": boolean
}
الحقول
name

string

النتائج فقط. اسم المورِد الخاص بـ "العميل المحتمل". التنسيق: partners/{partner_id}/leads/{lead_id}

engagementModel

enum (EngagementModel)

مطلوب. نموذج المشاركة الفعّالة للشركاء

dealTransactionType

enum (DealTransactionType)

مطلوب. نوع معاملة الصفقة

customer

object (Customer)

مطلوب. تمثّل حساب العميل.

partnerAnnualContractValue

number

مطلوب. قيمة العقد السنوية المقدَّرة للشريك

leadCurrencyCode

string

مطلوب. رمز عملة العميل المحتمل

estimatedCloseDate

object (Date)

مطلوب. تاريخ إغلاق الصفقة المقدَّر

dealTerm

string

مطلوب. مدة الصفقة

opportunitySummary

string

مطلوب. ملخّص فرصة التحسين

supportLevel

enum (SupportLevel)

مطلوب. مستوى الدعم المطلوب للعميل المحتمل

productInterests[]

enum (ProductFamily)

مطلوب. المنتجات الأساسية التي تهمّك يمكن استخدام قيمة واحدة فقط في الوقت الحالي.

leadStatus

enum (State)

النتائج فقط. حالة العميل المحتمل

leadApprovalStatus

enum (ApprovalState)

النتائج فقط. حالة الموافقة على العميل المحتمل.

submitterEmail

string

مطلوب. البريد الإلكتروني لمستخدم الشريك الذي يرسل بيانات العميل المحتمل

submittedTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إرسال بيانات العميل المحتمل

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية مع ما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

rejectionComments

string

النتائج فقط. تعليقات لرفض العميل المحتمل

approvalNotes

string

النتائج فقط. ملاحظات للموافقة على العميل المحتمل

externalSystemId

string

مطلوب. المعرّف الخارجي للعميل المحتمل

description

string

مطلوب. وصف العميل المحتمل

title

string

النتائج فقط. اسم سهل القراءة لتحديد العميل المحتمل

customerContactRequested

boolean

مطلوب. ما إذا كان العميل قد طلب التواصل معه

deliveryModel

enum (DeliveryModel)

مطلوب. طريقة العرض

contractVehicle

enum (ContractVehicle)

مطلوب. مركبة متعاقد عليها

isvSolutionConnectDeal

boolean

مطلوب. يشير إلى ما إذا كانت هذه صفقة ربط حلول من مورّدي البرامج المستقلين (ISV).

rejectionReason

enum (RejectionReason)

النتائج فقط. سبب رفض العميل المحتمل

leadSource

enum (LeadSource)

مصدر العميل المحتمل

createDate

object (Date)

النتائج فقط. تاريخ الإنشاء

budget

enum (Budget)

اختيارية: الميزانية

timeline

enum (Timeline)

اختيارية: المخطط الزمني

authority

enum (Authority)

اختيارية: جهة الإصدار

need

enum (Need)

اختيارية: الحاجة

isPublicTender

boolean

اختيارية: تحدّد ما إذا كانت "العميل المحتمل" استجابة لطلب تقديم عروض أو مناقصة عامة أو عرض تنافسي. تشير الإجابة "نعم" إلى أنّ عميلك هو مؤسسة تابعة للقطاع العام ويتطلّب عروضًا تنافسية من عدة مورّدين.

isConfidential

boolean

اختيارية: تُستخدَم لتحديد ما إذا كانت بيانات العميل المحتمل سرية.

EngagementModel

تحدّد هذه السمة "نموذج التفاعل" الذي يشترك فيه الشريك.

عمليات التعداد
ENGAGEMENT_MODEL_UNSPECIFIED لم يتم تحديد أي منها.
ENGAGEMENT_MODEL_BUILD تمثّل شريك تصميم الحلول.
ENGAGEMENT_MODEL_SERVICE تمثّل هذه السمة شريك خدمة.

DealTransactionType

تمثّل هذه السمة نوع معاملة الصفقة.

عمليات التعداد
DEAL_TRANSACTION_TYPE_UNSPECIFIED لم يتم تحديد أي منها.
DEAL_TRANSACTION_TYPE_DEAL_SUBMISSION تمثّل هذه السمة عملية إرسال الصفقات.

SupportLevel

تمثّل هذه السمة مستوى الدعم المطلوب في "العميل المحتمل".

عمليات التعداد
SUPPORT_LEVEL_UNSPECIFIED لم يتم تحديد أي منها.
SUPPORT_LEVEL_TECHNICAL_SUPPORT الدعم الفني
SUPPORT_LEVEL_UP_SELLING_OR_CROSS_SELLING دعم الارتقاء بالمبيعات/التجديد/بيع منتجات إضافية
SUPPORT_LEVEL_ALIGN_SALES_OR_ACCOUNT_STRATEGY تحديد استراتيجية المبيعات/الحساب
SUPPORT_LEVEL_ALREADY_IN_TOUCH_WITH_CLOUD_SALES التواصل مع فريق مبيعات Google Cloud
SUPPORT_LEVEL_OTHER غير ذلك (يُرجى استخدام حقل "ملخّص الفرصة" لتقديم توضيح).

الحالة

تمثّل هذه السمة حالة العميل المحتمل.

عمليات التعداد
STATE_UNSPECIFIED لم يتم تحديد أي منها.
STATE_SUBMITTED تم إرسال العميل المحتمل.
STATE_REVIEWED جارٍ مراجعة العميل المحتمل.
STATE_CONVERTED يتم تحويل العميل المحتمل إلى فرصة.
STATE_NEW تم إنشاء العميل المحتمل حديثًا.

ApprovalState

تمثّل هذه السمة حالة الموافقة على العميل المحتمل.

عمليات التعداد
APPROVAL_STATE_UNSPECIFIED لم يتم تحديد أي منها.
APPROVAL_STATE_IN_PROCESS جارٍ الموافقة على العميل المحتمل.
APPROVAL_STATE_APPROVED تمّت الموافقة على العميل المحتمل.
APPROVAL_STATE_NOT_APPROVED لم تتم الموافقة على العميل المحتمل.
APPROVAL_STATE_MORE_INFO_REQUIRED يجب توفير المزيد من المعلومات للموافقة على العميل المحتمل.

DeliveryModel

تمثّل هذه السمة نموذج تسليم العميل المحتمل.

عمليات التعداد
DELIVERY_MODEL_UNSPECIFIED لم يتم تحديد أي منها.
DELIVERY_MODEL_VM_ON_CUSTOMER_TENANCY الجهاز الافتراضي في مستأجر العميل
DELIVERY_MODEL_SAAS_ON_GCP ‫SaaS على Google Cloud Platform
DELIVERY_MODEL_OTHER غير ذلك

ContractVehicle

تمثّل هذه السمة المركبة المتعاقد عليها في العميل المحتمل.

عمليات التعداد
CONTRACT_VEHICLE_UNSPECIFIED لم يتم تحديد أي منها.
CONTRACT_VEHICLE_MARKETPLACE Marketplace
CONTRACT_VEHICLE_NOT_KNOWN_AT_THIS_TIME لا نعرف ذلك في الوقت الحالي.
CONTRACT_VEHICLE_PARTNER_CONTRACT عقد الشريك

RejectionReason

تمثّل هذه السمة سبب رفض العميل المحتمل.

عمليات التعداد
REJECTION_REASON_UNSPECIFIED لم يتم تحديد أي منها.
REJECTION_REASON_DUPLICATE_LEAD مكرّرة في النظام
REJECTION_REASON_DOES_NOT_MEET_ELIGIBILITY_CRITERIA لا يستوفي الحدّ الأدنى من معايير الأهلية.
REJECTION_REASON_ADDITIONAL_INFO_NOT_RECEIVED لم يتم استلام معلومات إضافية خلال 30 يومًا.

LeadSource

تمثّل مصدر العميل المحتمل.

عمليات التعداد
LEAD_SOURCE_UNSPECIFIED لم يتم تحديد أي منها.
LEAD_SOURCE_WORKSPAN WorkSpan.

الميزانية

تمثّل هذه السمة مدى وضوح حالة ميزانية العميل المحتمل.

عمليات التعداد
BUDGET_UNSPECIFIED لم يتم تحديد أي منها.
BUDGET_EXISTS_BUT_NOT_SPECIFIED الميزانية متوفّرة، ولكن لم يتم تحديدها.
EXACT_BUDGET_GIVEN تم تقديم الميزانية الدقيقة.
REFUSE_TO_DISCLOSE رفض الإفصاح
CONFIRMED_NO_BUDGET تم تأكيد عدم توفّر ميزانية.

المخطط الزمني

تمثّل هذه السمة مدى تحديد العميل المحتمل للجدول الزمني لاتخاذ القرار.

عمليات التعداد
TIMELINE_UNSPECIFIED لم يتم تحديد أي منها.
SPECIFIC_DECISION_DATES_GIVEN قرار محدّد - تواريخ محدّدة
VAGUE_DECISION_DATES_GIVEN قرار غامض - تم تقديم تواريخ
REFUSE_TO_GIVE_DATE رفض تقديم التاريخ
CONFIRMED_NO_DECISION_DATE لم يتم تأكيد تاريخ اتخاذ القرار.

الجهة

تمثّل هذه السمة مدى قدرتك على تحديد عملية اتخاذ القرار لدى العميل المحتمل.

عمليات التعداد
AUTHORITY_UNSPECIFIED لم يتم تحديد أي منها.
HAVE_CLEARLY_IDENTIFIED_PROCESS أن تتضمّن عملية وأشخاصًا محدّدين بوضوح
HAVE_VAGUE_UNDERSTANDING لديك فهم غامض.
DONT_KNOW لا أعرف.
CONFIRMED_NO_AUTHORITY_DECIDED لم تتخذ أي جهة قرارًا بشأنها.

تحديد الاحتياجات

تمثّل هذه السمة مدى إلحاح حاجة العميل المحتمل إلى شراء حلّ (ليس بالضرورة حلّنا) لحلّ مشكلة تجارية.

عمليات التعداد
NEED_UNSPECIFIED لم يتم تحديد أي منها.
COMELLING_NEED حاجة ملحّة
CLEAR_NEED حاجة واضحة
NO_NEED لا حاجة إلى ذلك.

الطُرق

create

تُنشئ هذه الطريقة عميلاً محتملاً لأحد الشركاء.

get

الحصول على عميل محتمل