سيتم إيقاف Search Ads 360 Reporting API السابقة نهائيًا وإيقافها في 30 حزيران (يونيو) 2024. يُرجى العلم أنّ Search Ads 360 Conversion API لم تتأثر بهذه المشكلة وستظلّ متاحة. يجب أن تستخدم جميع عمليات تطوير إعداد التقارير الجديدة Search Ads 360 Reporting API الجديدة.

اعتبارًا من نيسان (أبريل) 2024، سيظهر خطأ غير متوافق مع ApiVersion عند طلب تقرير. اطّلع على التفاصيل هنا.

ننصحك بشدة بنقل أي عمليات تنفيذ حالية لخدمة "إعلانات شبكة البحث 360" إلى واجهة برمجة التطبيقات الجديدة. لمزيد من المعلومات، اطّلِع على البدء ودليل نقل البيانات في Search Ads 360 Reporting API الجديدة.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Conversion: update

تعمل على تعديل دُفعة من الإحالات الناجحة في DoubleClick Search. تجربة ذلك الآن

الطلب

طلب HTTP

PUT https://www.googleapis.com/doubleclicksearch/v2/conversion

التفويض

يتطلب هذا الطلب تفويضًا بالنطاق التالي:

النطاق
`https://www.googleapis.com/auth/doubleclicksearch`

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

في نص الطلب، قدِّم مورد إحالة ناجحة مع السمات التالية:

اسم الموقع	القيمة	الوصف	ملاحظات
الخصائص الاختيارية
`conversion[].currencyCode`	`string`	رمز العملة لأرباح الإحالة الناجحة. يجب أن يكون بتنسيق ISO 4217 الأبجدي (3 أحرف).	قابل للكتابة
`conversion[].quantityMillis`	`long`	مقدار هذه الإحالة الناجحة بالمللي ثانية	قابل للكتابة
`conversion[].revenueMicros`	`long`	مبلغ أرباح هذه الإحالة الناجحة البالغ عددها `TRANSACTION` بالمايكرو (القيمة مضروبة في 1000000، بدون علامة عشرية). على سبيل المثال، لتحديد قيمة أرباح "10" أدخِل "10000000". (10 ملايين) في طلبك.	قابل للكتابة
`conversion[].state`	`string`	حالة الإحالة الناجحة، وهي إما `ACTIVE` أو `REMOVED`. ملاحظة: تم إيقاف الحالة "DELETED" نهائيًا. في ما يلي القيم المقبولة: "`ACTIVE`" "`DELETED`": (متوقّفة نهائيًا) "`REMOVED`"	قابل للكتابة

الرد

في حال نجاح هذه الطريقة، سيتم عرض مورد إحالة ناجحة في نص الاستجابة.

جرّب الآن

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ. ويمكنك بدلاً من ذلك تجربة مستقل Explorer (المستكشف):